一种结算设置,用于将付款账号与广告客户相关联。一项结算设置特定于一个广告客户。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resourceName |
不可变。结算设置的资源名称。BillingSetup 资源名称采用以下格式:
|
status |
仅供输出。结算设置的状态。 |
paymentsAccountInfo |
不可变。与此结算设置相关联的付款账号信息。设置结算信息时,这用于注册新的付款帐号(之后不应设置 paymentsAccount)。获取结算设置时,系统会填充此 和 paymentsAccount。 |
id |
仅供输出。结算设置的 ID。 |
paymentsAccount |
不可变。与此结算设置相关联的付款帐号的资源名称。付款资源名称采用以下格式:
|
联合字段 提取现有结算设置时,这是请求的开始时间。不过,如果该设置在请求的开始时间之后获得批准(查看状态),则这是审批时间。 |
|
startDateTime |
不可变。采用 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss 格式的开始日期和时间。只能选择未来的时间。 |
startTimeType |
不可变。开始时间,是一个类型。只允许使用 NOW。 |
联合字段 end_time 。结算设置结束 / 结束时。该时间可以是“永久”,也可以是下一个已安排的结算设置的开始时间。end_time 只能是下列其中一项: |
|
endDateTime |
仅供输出。采用 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss 格式的结束日期时间。 |
endTimeType |
仅供输出。作为一种类型的结束时间。唯一可能的值为 FOREVER。 |
BillingSetupStatus
BillingSetup 的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PENDING |
结算设置正在等待审批。 |
APPROVED_HELD |
结算设置已获批准,但对应的首笔预算尚未获得批准。这仅适用于针对按月账单结算配置的结算设置。 |
APPROVED |
结算设置已获批准。 |
CANCELLED |
在批准之前,用户取消了结算设置。 |
PaymentsAccountInfo
用于存放此结算的付款账号信息的容器。
JSON 表示法 |
---|
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string } |
字段 | |
---|---|
paymentsAccountId |
仅供输出。一个 16 位数的 ID,用于标识与结算设置相关联的付款帐号。 该参数必须以带短划线的字符串形式传递,例如“1234-5678-9012-3456”。 |
paymentsAccountName |
不可变。与结算设置相关联的付款帐号的名称。 这样,用户就可以为付款帐号指定有意义的名称,以帮助对月度账单进行对帐。 此名称将显示在月度账单中。 |
paymentsProfileId |
不可变。一个 12 位数的 ID,用于标识与结算设置相关联的付款资料。 该参数必须以带短划线的字符串形式传入,例如“1234-5678-9012”。 |
paymentsProfileName |
仅供输出。与结算设置相关联的付款资料的名称。 |
secondaryPaymentsProfileId |
仅供输出。在非常见情况下(例如,签订了顺序责任协议时)显示的二级付款资料 ID。 |