帳單設定

帳單設定是 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 帳戶，請將 payments_account 設為有效 Payments 帳戶的資源 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 中的大多數其他實體一樣，BillingSetup 是透過查詢 GoogleAdsService.SearchStream 擷取，並使用 Google Ads 查詢語言查詢指定要傳回的欄位。

取得 BillingSetup 的參照後，即可按照「帳戶預算」一文的說明，使用該參照建立 AccountBudgetProposal。

取消待處理的帳單設定

尚未生效的 BillingSetup 可使用移除作業取消。只有在帳單設定的status為PENDING或APPROVED未來開始時，才能取消帳單設定。