料金の設定

お支払い情報の設定は、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: お支払い情報の設定に関連付けられたお支払いプロファイルを識別するために使用される、 ハイフンで区切られた文字列形式の 12 桁の ID（例: "1234-5678-9012"）。

お支払いアカウントが統合請求の対象となる場合、複数の Google 広告アカウントのお支払い情報の設定で同じお支払いアカウントを使用するように設定すると、それらのアカウントを同じ請求書にまとめることができます。

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

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

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

既存のお支払いアカウントにリンクするには、payments_account を有効なお支払いアカウントのリソース名（customers/{customer_id}/paymentsAccounts/{payments_account_id} など）に設定します。ただし、payments_account_info は変更しないでください。

PaymentsAccountService.ListPaymentsAccounts メソッドを使用して、利用可能なお支払いアカウントを一覧表示できます。返される PaymentsAccount オブジェクトは、認証に使用するマネージャー アカウントによって異なります。

各 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されている場合のみです。

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