お支払い情報の設定

お支払い情報の設定は、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 になります。

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

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

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

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

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

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

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