结算设置

结算设置是 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）：

• payments_account_name
• payments_profile_id

注意： payments_account 和 payments_account_info 在后续检索结算设置时都会被填充。

下面的示例演示了如何通过现有的支付资料 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 中的大多数其他实体一样，a BillingSetup 是通过使用 Google Ads 查询语言查询 GoogleAdsService.SearchStream 来提取的，该查询指定了要返回的字段。

获得对 BillingSetup 的引用后，您可以使用它来创建 AccountBudgetProposal，如账号预算中所述。

取消待处理的结算设置

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