结算设置是 Google Ads 帐号与付款帐号之间的帐号级关联(也称为“账单设置”),可有效确定由谁支付结算设置的帐号预算所产生的费用。每个付款帐号对应一份账单。
关于付款账号
每个 BillingSetup
都会标识一个付款帐号,该帐号会针对其帐号预算产生的费用开具账单。此付款帐号与最终负责支付费用的付款资料相关联。
结算设置包含一个 payments_account
字段和一组 payments_account_info
字段,用于标识正在使用的付款帐号,其中包括:
payments_account_info.payments_account_id
:一个 16 位数的 ID,用于标识与结算设置关联的付款帐号。payments_account_info.payments_account_name
:与结算设置关联的付款帐号的名称。此名称会印在月度账单上。payments_account_info.payments_profile_id
:一个 12 位数的 ID,用于标识与结算设置相关联的付款资料。
如果付款帐号符合合并结算的条件,那么可以将多个 Google Ads 帐号的结算设置设置为使用相同的基础付款帐号,从而将多个 Google Ads 帐号分组到同一帐单中。
创建新的结算设置
您可以将新的结算设置关联到现有付款帐号或同时创建的帐号。
使用现有的付款帐号
如需与现有付款帐号相关联,请将 payments_account
设置为有效付款帐号的资源 ID。不过,请勿修改 payments_account_info
。
您可以使用 PaymentsAccountService.ListPaymentsAccounts
方法列出可用的付款帐号。返回的 PaymentsAccounts
取决于您用于身份验证的经理帐号。
对于每个 PaymentsAccount
,其付款经理帐号的 ID 位于 paying_manager_customer
字段中。
使用新的付款帐号
如需关联新的付款帐号,请在 payments_account_info
中设置以下字段(请勿设置 payments_account
):
以下示例展示了如何利用现有付款资料 ID 创建新的结算设置。如上所述,此操作还会创建一个名为 My New Payments Account
的新付款帐号。
BillingSetup bsetup = BillingSetup.newBuilder()
.setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
.setPaymentsAccountName("My New Payments Account")
.setPaymentsProfileId("1234-5678-9012")
.build())
.setStartTimeType(TimeType.NOW)
.build();
BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();
try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
.getBillingSetupServiceClient()) {
MutateBillingSetupResponse response =
billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}
如果这是第一个添加到 Google Ads 帐号的结算设置,这将使客户有效地使用引用的付款资料注册结算。
结算设置状态
新的 BillingSetup
实例需要接受批准,然后才能生效。在此之前,其 status
处于 PENDING
状态。
BillingSetup
可以是以下 status
之一:
结算设置状态 | 说明 |
---|---|
PENDING |
待批准。 |
APPROVED_HELD |
已获批准,但对应的第一项预算尚未获得批准。这仅适用于针对按月账单结算配置的结算设置。 |
APPROVED |
设置已获批准。 |
CANCELLED |
在获得批准之前,用户取消了设置。 |
检索帐号的结算设置
与 Google Ads API 中的大多数其他实体一样,BillingSetup
是通过使用指定了要返回哪些字段的 Google Ads 查询语言查询来查询 GoogleAdsService.SearchStream
来获取的。
获得对 BillingSetup
的引用后,您可以使用它来创建 AccountBudgetProposal
,如帐号预算中所述。
取消待处理的结算设置
您可以使用移除操作取消尚未生效的 BillingSetup
。只有当其 status
为 PENDING
或 APPROVED
在未来某个时间开始时,才能取消结算设置。