お支払い情報の設定

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

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

各 BillingSetup により、アカウントの予算に基づいて発生した費用に対して請求されるお支払いアカウントが識別されます。このお支払いアカウントはお支払いプロファイルに関連付けられており、最終的な請求先となります。

お支払い情報の設定には、payments_account フィールドと、使用中のお支払いアカウントを識別する payments_account_info フィールドのグループの両方が含まれます。次に例を示します。

お支払いアカウントで統合請求が可能な場合、お支払い情報の設定に基礎となる同じお支払いアカウントを設定することで、複数の 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 承認前に設定がユーザーによってキャンセルされました。

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

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

BillingSetup への参照を取得したら、アカウントの予算で説明されているように、その参照を使用して AccountBudgetProposal を作成できます。

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

まだ有効になっていない BillingSetup は、remove オペレーションを使用してキャンセルできます。お支払い情報の設定は、status が PENDING の場合、または APPROVED（まだ始まっていない）の場合にのみキャンセルが可能です。

前へ
概要
次へ
アカウントの予算