帳單設定是 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
):
以下範例說明如何使用現有的付款資料 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
未來開始時,才能取消帳單設定。