结算设置是 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 中的大多数其他实体一样,系统会通过使用指定了要返回的字段的 Google Ads 查询语言查询来查询 GoogleAdsService.SearchStream
,从而提取 BillingSetup
。
获得对 BillingSetup
的引用后,您可以使用它来创建 AccountBudgetProposal
,如帐号预算中所述。
取消待处理的结算设置
可以使用移除操作取消尚未生效的 BillingSetup
。只有当其 status
为 PENDING
或 APPROVED
在未来某个时间开始时,才能取消结算设置。