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} 设置结算时，此字段用于使用现有付款账号进行注册（然后不应设置 paymentsAccountInfo）。完成结算设置时，系统会填充此 ID 和 paymentsAccountInfo。

联合字段 start_time。创建新的结算设置时，此设置应在该时间生效。如果客户没有任何已获批准的设置，则“立即”是唯一可接受的开始时间。

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

string

不可变。开始日期时间，采用 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss 格式。只能使用未来时间。
startTimeType

enum (TimeType)

不可变。开始时间类型。仅允许 NOW。
联合字段 end_time。结算设置的结束时间/结束日期。此值为“FOREVER”（永久）或下一个已安排的结算设置的开始时间。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。