结算设置

结算设置是 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 账号的结算设置，让其使用同一个基础付款账号，从而将这些账号分组到同一账单。

创建新的结算设置

您可以将新的结算设置关联到现有的付款账号，也可以关联到同时创建的付款账号。

使用现有付款账号

如需关联现有的付款账号，请将 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，如账号预算中所述。

取消待处理的结算设置

使用 remove 操作可以取消尚未生效的 BillingSetup。只有当结算设置的 status 为 PENDING 或处于 APPROVED 状态并且要在将来某个时间开始时，您才可以取消它们。

概览

帐号预算