结算设置

结算设置是 Google Ads 帐号与付款帐号之间的帐号级关联(也称为账单设置),可有效确定由谁负责支付结算设置的帐号预算所产生的费用。每个付款帐号对应一份账单。

关于付款账号

每个 BillingSetup 均标识一个付款帐号,该帐号会针对其帐号预算产生的费用开具账单。此付款帐号与最终负责支付费用的付款资料相关联。

结算设置包含 payments_account 字段和一组 payments_account_info 字段,用于标识正在使用的付款帐号,其中包括:

如果付款帐号符合合并结算的条件,则可以通过设置多个 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。仅当结算设置的 statusPENDINGAPPROVED 将在未来某个时间开始时,您才能取消结算设置。