Method: customers.billingSetups.mutate

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

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

HTTP リクエスト

POST https://googleads.googleapis.com/v16/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

オペレーションが正常に完了した場合に返されます。