お支払い情報の設定とは、Google 広告アカウントとお支払いアカウント（請求書の設定とも呼ばれます）間のアカウント単位のリンクです。このリンクにより、お支払い情報の設定のアカウント予算で発生した費用の請求先が実質的に決定されます。各お支払いアカウントは 1 つの請求書に対応します。
お支払いアカウントについて
各 BillingSetup は、アカウントの予算によって発生した費用の請求先となるお支払いアカウントを識別します。このお支払いアカウントは、最終的に料金の支払い責任を負うお支払いプロファイルに関連付けられています。
お支払い情報の設定には、payments_account フィールドと、使用中のお支払いアカウントを識別する payments_account_info フィールドのグループの両方が含まれます。
payments_account_info.payments_account_id: お支払い情報の設定に関連付けられたお支払いアカウントを識別するために使用される、ハイフンで区切られた文字列（例:"1234-5678-9012-3456"）としてフォーマットされた 16 桁の ID。payments_account_info.payments_account_name: お支払い情報の設定に関連付けられているお支払いアカウントの名前。この名前は毎月の請求書に印刷されます。payments_account_info.payments_profile_id: 請求先設定に関連付けられているお支払いプロファイルを識別するために使用される、ハイフン付きの文字列（例:"1234-5678-9012"）としてフォーマットされた 12 桁の ID。
お支払いアカウントが統合請求の対象となる場合、お支払い情報の設定で同じ基盤となるお支払いアカウントを使用するように設定することで、複数の Google 広告アカウントを同じ請求書にグループ化できます。
新しいお支払い情報を作成する
新しいお支払い情報を既存のお支払いアカウントにリンクすることも、同時に作成したお支払いアカウントにリンクすることもできます。
既存のお支払いアカウントを使用する
既存のお支払いアカウントにリンクするには、payments_account を有効なお支払いアカウントのリソース名（customers/{customer_id}/paymentsAccounts/{payments_account_id} など）に設定します。ただし、payments_account_info は変更しないでください。
利用可能なお支払いアカウントは、PaymentsAccountService.ListPaymentsAccounts メソッドで一覧表示できます。返される PaymentsAccount オブジェクトは、認証に使用する MCC アカウントによって異なります。
各 PaymentsAccount のお支払い元アカウントのリソース名は、paying_manager_customer フィールドにあります。
新しいお支払いアカウントを使用する
新しいお支払いアカウントにリンクするには、payments_account_info で次のフィールドを設定します（payments_account は設定しないでください）。
次の例は、既存のお支払いプロファイル ID から新しいお支払い情報の設定を作成する方法を示しています。前述のとおり、この操作により My New Payments Account という名前の新しいお支払いアカウントも作成されます。
BillingSetup billingSetup =
BillingSetup.newBuilder()
.setPaymentsAccountInfo(
PaymentsAccountInfo.newBuilder()
.setPaymentsAccountName("My New Payments Account")
.setPaymentsProfileId("1234-5678-9012")
.build())
.setStartTimeType(TimeTypeEnum.TimeType.NOW)
.build();
BillingSetupOperation operation =
BillingSetupOperation.newBuilder().setCreate(billingSetup).build();
try (BillingSetupServiceClient billingSetupServiceClient =
googleAdsClient.getBillingSetupServiceClient()) {
MutateBillingSetupResponse response =
billingSetupServiceClient.mutateBillingSetup(
Long.toString(customerId), operation);
}
Google 広告アカウントに初めてお支払い情報の設定を追加する場合は、参照されたお支払いプロファイルを使用して、お客様がお支払いに登録することになります。
お支払い情報設定のステータス
新しい BillingSetup インスタンスは、有効になる前に承認を受ける必要があります。それまでは、status は PENDING 状態になります。
BillingSetup には、次のいずれかの status 値を指定できます。
BillingSetupStatus |
説明 |
|---|---|
PENDING |
承認待ち |
APPROVED_HELD |
承認済みですが、対応する最初の予算が承認されていません。これは、毎月の請求書発行に設定されているお支払い情報の設定に対してのみ発生する可能性があります。 |
APPROVED |
設定が承認されています。 |
CANCELLED |
承認前に設定がユーザーによってキャンセルされました。 |
アカウントのお支払い情報の設定を取得する
Google Ads API の他のほとんどのエンティティと同様に、BillingSetup は、返すフィールドを指定する Google 広告クエリ言語（GAQL）クエリを使用して GoogleAdsService.Search または GoogleAdsService.SearchStream をクエリすることで取得されます。
SELECT
billing_setup.resource_name,
billing_setup.id,
billing_setup.status,
billing_setup.payments_account,
billing_setup.payments_account_info.payments_account_id,
billing_setup.payments_account_info.payments_account_name,
billing_setup.payments_account_info.payments_profile_id,
billing_setup.payments_account_info.payments_profile_name,
billing_setup.start_date_time,
billing_setup.end_date_time,
billing_setup.end_time_type
FROM billing_setup
BillingSetup への参照を取得したら、アカウントの予算で説明されているように、それを使用して AccountBudgetProposal を作成できます。
保留中のお支払い情報の設定をキャンセルする
まだ有効になっていない BillingSetup をキャンセルするには、remove フィールドが課金設定のリソース名（customers/{customer_id}/billingSetups/{billing_setup_id}）に設定された BillingSetupOperation を送信します。課金設定をキャンセルできるのは、status が PENDING の場合、または将来のある時点で開始するように APPROVED になっている場合のみです。