Method: customers.billingSetups.mutate

お支払い情報を作成するか、既存のお支払い情報をキャンセルします。

スローされるエラーのリスト: AuthenticationError AuthorizationError BillingSetupError DateError FieldError HeaderError InternalError MutateError QuotaError RequestError

HTTP リクエスト

POST https://googleads.googleapis.com/v14/customers/{customerId}/billingSetups:mutate

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。お支払い情報の設定の変更オペレーションを適用する顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "operation": {
    object (BillingSetupOperation)
  }
}
フィールド
operation

object (BillingSetupOperation)

必須。実行するオペレーション。

レスポンスの本文

お支払い情報の設定オペレーションに対するレスポンス メッセージ。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "result": {
    object (MutateBillingSetupResult)
  }
}
フィールド
result

object (MutateBillingSetupResult)

ミューテーション リクエストの影響を受けるリソースを識別する結果。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/adwords

詳細については、OAuth 2.0 の概要をご覧ください。

BillingSetupOperation

お支払い情報の設定に対する 1 回の操作で、既存のお支払い情報の設定のキャンセルを表します。

JSON 表現 
{

  // Union field operation can be only one of the following:
  "create": {
    object (BillingSetup)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
フィールド
共用体フィールド operation。設定できるオペレーションは 1 つのみです。「更新」オペレーションはサポートされていません。operation は次のいずれかになります。
create

object (BillingSetup)

お支払い情報の設定を作成します。新しいお支払い情報の設定ではリソース名は不要です。
remove

string

削除するお支払い情報設定のリソース名。ステータスが保留中の場合や、スケジュール設定された開始時間が将来の設定の場合以外は、設定を削除できません。リソース名は customers/{customerId}/billingSetups/{billing_id} のような形式になります。

MutateBillingSetupResult

単一のお支払い情報設定の変更の結果。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

成功したオペレーションに対して返されます。