BillingSetup

JSON 表示法
BillingSetupStatus
PaymentsAccountInfo
- JSON 表示法

结算设置，用于将付款账号与广告客户相关联。一项结算设置特定于一个广告客户。

JSON 表示法

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,
  "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}` 设置结算信息时，这是为了使用现有付款帐号（若不应设置 paymentsAccountInfo）进行注册。获取结算设置时，将会填充此信息和 paymentsAccountInfo。
联合字段 `start_time`。创建新的结算设置时，该设置应生效。如果客户没有任何已获批准的设置，则“NOW”是唯一可接受的开始时间。提取现有结算设置时，这是指请求的开始时间。不过，如果该设置在请求的开始时间之后已获批准（查看状态），则这就是审批时间。`start_time` 只能是下列其中一项：
`startDateTime`	`string` 不可变。采用 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss 格式的开始日期时间。只能选择未来的时间。
`startTimeType`	`enum (TimeType)` 不可变。开始时间，是一个类型。仅允许使用现在。
联合字段 `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。