BillingSetup

Thông tin thanh toán liên kết tài khoản thanh toán với nhà quảng cáo. Thông tin thanh toán chỉ dành cho một nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của thông tin thanh toán. Tên tài nguyên BillingSetup có dạng như sau:

customers/{customerId}/billingSetups/{billing_setup_id}
status

enum (BillingSetupStatus)

Chỉ có đầu ra. Trạng thái của thông tin thanh toán.
paymentsAccountInfo

object (PaymentsAccountInfo)

Không thể thay đổi. Thông tin tài khoản thanh toán được liên kết với thông tin thanh toán này. Khi thiết lập thông tin thanh toán, tài khoản này được dùng để đăng ký tài khoản thanh toán mới (sau đó, bạn không nên thiết lập paymentsAccount). Khi bạn thiết lập thông tin thanh toán, hệ thống sẽ điền thông tin này và tài khoản thanh toán.
id

string (int64 format)

Chỉ có đầu ra. Mã thông tin thanh toán.
paymentsAccount

string

Không thể thay đổi. Tên tài nguyên của tài khoản thanh toán được liên kết với thông tin thanh toán này. Tên tài nguyên thanh toán có dạng:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} Khi thiết lập thông tin thanh toán, tên này được dùng để đăng ký bằng tài khoản thanh toán hiện có (sau đó, bạn không nên đặt paymentsAccountInfo). Khi bạn thiết lập thông tin thanh toán, thông tin này và paymentsAccountInfo sẽ được điền.

Trường hợp start_time. Đây là thời điểm thông tin thanh toán mới sẽ có hiệu lực khi bạn tạo thông tin thanh toán mới. HIỆN TẠI là thời điểm bắt đầu duy nhất được chấp nhận nếu khách hàng chưa có thông tin thiết lập nào được phê duyệt.

Khi tìm nạp thông tin thanh toán hiện tại, đây là thời gian bắt đầu được yêu cầu. Tuy nhiên, nếu quy trình thiết lập được phê duyệt (xem trạng thái) sau thời gian bắt đầu được yêu cầu, thì đây là thời gian phê duyệt. start_time chỉ có thể là một trong những trạng thái sau:
startDateTime

string

Không thể thay đổi. Ngày bắt đầu ở định dạng yyyy-MM-dd hoặc yyyy-MM-dd HH:mm:ss. Bạn chỉ được phép nhập một thời điểm trong tương lai.
startTimeType

enum (TimeType)

Không thể thay đổi. Thời gian bắt đầu dưới dạng một loại. Chỉ cho phép NOW.
Trường hợp end_time. Thời điểm kết thúc / kết thúc thông tin thanh toán. Đây là thời điểm VĨNH VIỄN hoặc thời gian bắt đầu của thông tin thanh toán được lập lịch tiếp theo. end_time chỉ có thể là một trong những trạng thái sau:
endDateTime

string

Chỉ có đầu ra. Ngày kết thúc ở định dạng yyyy-MM-dd hoặc yyyy-MM-dd HH:mm:ss.
endTimeType

enum (TimeType)

Chỉ có đầu ra. Thời gian kết thúc là một loại. Giá trị duy nhất có thể là VĨNH VIỄN.

BillingSetupStatus

Các trạng thái có thể có của một BillingSetup.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
PENDING Thông tin thanh toán đang chờ phê duyệt.
APPROVED_HELD Thông tin thanh toán đã được phê duyệt nhưng ngân sách đầu tiên tương ứng chưa được phê duyệt. Điều này chỉ có thể xảy ra đối với những thông tin thanh toán được thiết lập để sử dụng phương thức lập hoá đơn hằng tháng.
APPROVED Thông tin thanh toán đã được phê duyệt.
CANCELLED Người dùng đã huỷ thông tin thanh toán trước khi được phê duyệt.

PaymentsAccountInfo

Vùng chứa thông tin tài khoản thanh toán cho việc lập hoá đơn này.

Biểu diễn dưới dạng JSON 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
Trường
paymentsAccountId

string

Chỉ có đầu ra. Mã nhận dạng gồm 16 chữ số được dùng để xác định tài khoản thanh toán được liên kết với thông tin thanh toán.

Giá trị này phải được chuyển dưới dạng chuỗi có dấu gạch ngang, ví dụ: "1234-5678-9012-3456".
paymentsAccountName

string

Không thể thay đổi. Tên của tài khoản thanh toán được liên kết với thông tin thanh toán.

Điều này cho phép người dùng chỉ định một tên có ý nghĩa cho tài khoản thanh toán để hỗ trợ điều chỉnh các hoá đơn hằng tháng.

Tên này sẽ được in trong hoá đơn hằng tháng.
paymentsProfileId

string

Không thể thay đổi. Mã nhận dạng gồm 12 chữ số được dùng để xác định hồ sơ thanh toán được liên kết với thông tin thanh toán.

Giá trị này phải được chuyển dưới dạng chuỗi có dấu gạch ngang, ví dụ: "1234-5678-9012".
paymentsProfileName

string

Chỉ có đầu ra. Tên của hồ sơ thanh toán được liên kết với thông tin thanh toán.
secondaryPaymentsProfileId

string

Chỉ có đầu ra. Mã hồ sơ thanh toán phụ xuất hiện trong các trường hợp không phổ biến, ví dụ: khi đã sắp xếp một thỏa thuận trách nhiệm pháp lý tuần tự.