Method: customers.campaignAssets.mutate

キャンペーン アセットを作成、更新、または削除します。オペレーションのステータスが返されます。

スローされるエラーのリスト: AssetLinkError AuthenticationError AuthorizationError ContextError DatabaseError FieldError HeaderError InternalError MutateError NotAllowlistedError QuotaError RequestErrorRequestError

HTTP リクエスト

POST https://googleads.googleapis.com/v16/customers/{customerId}/campaignAssets:mutate

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

パスパラメータ

パラメータ
customerId

string

必須。キャンペーン アセットを変更する顧客の ID。

リクエスト本文

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

JSON 表現
{
  "operations": [
    {
      object (CampaignAssetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
フィールド
operations[]

object (CampaignAssetOperation)

必須。個々のキャンペーン アセットに対して実行するオペレーションのリストです。

partialFailure

boolean

true の場合、成功したオペレーションが実行され、無効なオペレーションはエラーを返します。false の場合、すべてのオペレーションが有効な場合にのみ、1 つのトランザクションで実行されます。デフォルトは false です。

validateOnly

boolean

true の場合、リクエストは検証されますが、実行されません。エラーのみが返され、結果は返されません。

responseContentType

enum (ResponseContentType)

レスポンスのコンテンツ タイプの設定。ミューテーション後に可変リソースを返すか、リソース名のみを返すかを決定します。

レスポンスの本文

キャンペーン アセットの変更に対するレスポンス メッセージです。

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

JSON 表現
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateCampaignAssetResult)
    }
  ]
}
フィールド
partialFailureError

object (Status)

部分障害モードのオペレーションの失敗に関連するエラー。partialFailure = true で、すべてのエラーがオペレーション内で発生した場合にのみ返されます。オペレーションの外部でエラー(認証エラーなど)が発生した場合は、RPC レベルのエラーが返されます。

results[]

object (MutateCampaignAssetResult)

変換のすべての結果。

承認スコープ

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

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

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