BillingSetup

一种结算设置，可将付款账号与广告客户相关联。一项结算设置只能对应一个广告客户。

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.
}
字段
resourceName

string

不可变。结算设置的资源名称。BillingSetup 资源名称采用以下格式：

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

enum (BillingSetupStatus)

仅限输出。结算设置的状态。
paymentsAccountInfo

object (PaymentsAccountInfo)

不可变。与此结算设置相关联的付款账号信息。设置结算信息时，此域名用于注册新的付款帐号（不应设置 paymentsAccount）。完成结算设置时，系统会填充此账号和 paymentsAccount。
id

string (int64 format)

仅限输出。结算设置的 ID。
paymentsAccount

string

不可变。与此结算设置关联的付款账号的资源名称。付款资源名称采用以下格式：

customers/{customerId}/paymentsAccounts/{paymentsAccountId}设置结算时，此 ID 用于注册现有的付款帐号（不应设置 paymentsAccountInfo）。完成结算设置时，系统会填充此 ID 和 paymentsAccountInfo。

联合字段 start_time。创建新的结算设置时，设置将在此日期生效。如果客户没有任何已获批准的设置，则 NOW 是可接受的开始时间。

提取现有结算设置时，这是请求的开始时间。不过，如果设置在请求的开始时间之后获得批准（查看状态），则此时间就是审批的时间。start_time 只能是下列其中一项：
startDateTime

string

不可变。格式为 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss 的开始日期和时间。只允许选择未来的时间。
startTimeType

enum (TimeType)

不可变。开始时间类型。仅允许 NOW。
联合字段 end_time。结算设置结束 / 结束时。此字段可以是“无限期”，也可以是下一次预定的结算设置的开始时间。end_time 只能是下列其中一项：
endDateTime

string

仅限输出。结束日期时间，采用 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss 格式。
endTimeType

enum (TimeType)

仅限输出。结束时间类型。唯一可能的值为 FOREVER。

BillingSetupStatus

BillingSetup 的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
PENDING 结算设置正在等待批准。
APPROVED_HELD 结算设置已获批准，但对应的第一笔预算尚未获得批准。这仅适用于针对按月账单结算配置的结算设置。
APPROVED 结算设置已获批准。
CANCELLED 用户在批准之前取消了结算设置。

PaymentsAccountInfo

此结算的付款账号信息的容器。

JSON 表示法 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
字段
paymentsAccountId

string

仅限输出。一个 16 位 ID，用于标识与结算设置相关联的付款帐号。

此字段必须作为带短划线的字符串进行传递，例如“1234-5678-9012-3456”。
paymentsAccountName

string

不可变。与结算设置相关联的付款帐号的名称。

这样，用户便可以为付款帐号指定一个有意义的名称，以帮助对月度账单进行对帐。

此名称将印在月度账单中。
paymentsProfileId

string

不可变。一个 12 位数的 ID，用于标识与结算设置相关联的付款资料。

此参数必须以带短划线的字符串形式传入，例如“1234-5678-9012”。
paymentsProfileName

string

仅限输出。与结算设置相关联的付款资料的名称。
secondaryPaymentsProfileId

string

仅限输出。在不常见的情况下（例如签订了顺序责任协议时），存在二级付款资料 ID。