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 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.
}
Các 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, 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 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ã 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 thông tin thanh toán này. Tên tài nguyên thanh toán có biểu mẫu 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 đó bạn không nên đặt paymentsAccountInfo). Khi thiết lập thông tin thanh toán, hệ thống sẽ điền thông tin này và thông tin thanh toánAccountInfo.

Trường nhóm start_time. Khi bạn tạo thông tin thanh toán mới, thông tin thiết lập này sẽ có hiệu lực. HIỆN TẠI là thời gian 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 thông tin thiết lập được phê duyệt (xem trạng thái) sau thời gian bắt đầu theo 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 đây:
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 chọn thời gian 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 nhóm end_time. Khi thông tin thanh toán kết thúc / kết thúc. Đây là thời gian 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 đây:
endDateTime

string

Chỉ có đầu ra. Thời gian 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 dưới dạng 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 Thông tin thanh toán.

Enum
UNSPECIFIED Chưa xác đị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 tương ứng đầu tiên chưa được phê duyệt. Điều này chỉ có thể xảy ra đối với thông tin thanh toán được thiết lập để lập hoá đơn hằng tháng.
APPROVED Thông tin thanh toán đã được phê duyệt.
CANCELLED Người dùng đã hủy thông tin thanh toán trước khi phê duyệt.

PaymentsAccountInfo

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

Biểu diễn dưới dạng JSON 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
Các 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 một 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 trên các 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.

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 thoả thuận trách nhiệm pháp lý tuần tự đã được sắp xếp.