このページは Cloud Translation API によって翻訳されました。

お支払い情報の設定

お支払い情報の設定は、Google 広告アカウントとお支払いアカウント（請求書の設定とも呼ばれます）をアカウント単位でリンクしたものであり、アカウントの予算によって発生する費用の請求先を効果的に決定します。各お支払いアカウントは 1 つの請求書に対応しています。

お支払いアカウントについて

各 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 広告アカウントを同じ請求書にグループ化できます。

新しいお支払い情報の設定の作成

新しいお支払い情報の設定は、既存のお支払いアカウントまたは同時に作成されたお支払いアカウントにリンクできます。

既存のお支払いアカウントを使用する

既存のお支払いアカウントにリンクするには、payments_account を有効なお支払いアカウントのリソース ID に設定します。ただし、payments_account_info は変更しないでください。

PaymentsAccountService.ListPaymentsAccounts メソッドを使用すると、利用可能なお支払いアカウントを一覧表示できます。返される PaymentsAccounts は、認証に使用する MCC アカウントによって異なります。

各 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 広告アカウントに初めてお支払い情報を追加する場合、参照先のお支払いプロファイルを使用して、実質的にお支払い情報を登録します。

お支払い情報設定のステータス

新しい BillingSetup インスタンスは、有効になる前に承認を受ける必要があります。それまで、status は PENDING 状態になります。

BillingSetup は、次のいずれかの status になります。

お支払い情報の設定ステータス	説明
`PENDING`	承認待ち
`APPROVED_HELD`	承認されましたが、対応する最初の予算は承認されていません。これは、毎月の請求書発行に設定されているお支払い情報の設定に対してのみ発生する可能性があります。
`APPROVED`	設定が承認されています。
`CANCELLED`	承認前に設定がユーザーによってキャンセルされました。

アカウントのお支払い情報の設定を取得する

BillingSetup は、Google Ads API の他のほとんどのエンティティと同様に、返すフィールドを指定する Google 広告クエリ言語のクエリを使って GoogleAdsService.SearchStream にクエリを実行することで取得されます。

BillingSetup への参照を取得したら、それを使用して AccountBudgetProposal を作成できます（アカウントの予算を参照）。

保留中のお支払い情報の設定のキャンセル

まだ有効になっていない BillingSetup は、remove オペレーションを使用してキャンセルできます。お支払い情報の設定をキャンセルできるのは、status が PENDING であるか、APPROVED が将来の任意の時刻である場合のみです。

概要

アカウントの予算