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. Mỗi chế độ thanh toán chỉ dành riêng 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:

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 chế độ thanh toán này. Khi thiết lập thông tin thanh toán, thông tin này được dùng để đăng ký bằng một tài khoản thanh toán mới (sau đó, bạn không nên đặt paymentsAccount). Khi thiết lập thông tin thanh toán, thông tin này và paymentsAccount sẽ được điền sẵn.
id

string (int64 format)

Chỉ có đầu ra. Mã của 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 chế độ thiết lập thông tin thanh toán này. Tên tài nguyên thanh toán có dạng như sau:

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

Trường hợp hợp nhất start_time. Khi bạn tạo thông tin thanh toán mới, thông tin này sẽ có hiệu lực từ ngày đó. NGAY BÂY GIỜ là thời gian bắt đầu duy nhất được chấp nhận nếu khách hàng chưa có chế độ thiết lập nào được phê duyệt.

Khi tìm nạp thông tin thanh toán hiện có, đây là thời gian bắt đầu được yêu cầu. Tuy nhiên, nếu việc 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 giá trị 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. Chỉ cho phép thời gian trong tương lai.
startTimeType

enum (TimeType)

Không thể thay đổi. Thời gian bắt đầu ở dạng loại. Chỉ cho phép sử dụng NOW.
Trường hợp hợp nhất end_time. Thời điểm thiết lập thông tin thanh toán kết thúc/kết thúc. Đây là MÃI MÃI hoặc thời gian bắt đầu của thông tin thanh toán được lên lịch tiếp theo. end_time chỉ có thể là một trong những giá trị sau:
endDateTime

string

Chỉ có đầu ra. Thời gian kết thúc theo đị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 ở dạng một loại. Giá trị duy nhất có thể là FOREVER.

BillingSetupStatus

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
PENDING Thông tin thanh toán này đ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 định cấu hình để 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 khoản thanh toá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ố 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.

Mã này phải được truyền dưới dạng một 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 chế độ thanh toán.

Việc 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ợ việc điều chỉnh 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ố dùng để xác định hồ sơ thanh toán được liên kết với thông tin thanh toán.

Bạn phải truyền mã này dưới dạng một 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 những trường hợp không phổ biến, ví dụ như khi đã thu xếp thoả thuận trách nhiệm pháp lý tuần tự.