Method: customers.adGroupAssetSets.mutate

広告グループのアセットセットを作成または削除します。オペレーションのステータスが返されます。

HTTP リクエスト

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets:mutate

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

パスパラメータ

パラメータ
customerId

string

必須。広告グループのアセットセットが変更されるお客様の ID。

リクエストの本文

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

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

object (AdGroupAssetSetOperation)

必須。個々の広告グループのアセットセットに対して実行するオペレーションのリスト。
partialFailure

boolean

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

boolean

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

enum (ResponseContentType)

レスポンスのコンテンツ タイプの設定。変更後の変更可能なリソースを返すか、リソース名のみを返すかを決定します。

レスポンスの本文

広告グループのアセットセットの変更に対するレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

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

object (MutateAdGroupAssetSetResult)

ミューテーションのすべての結果。
partialFailureError

object (Status)

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

認可スコープ

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

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

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

AdGroupAssetSetOperation

広告グループのアセットセットに対する 1 つのオペレーション（作成、削除）。

JSON 表現 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
フィールド
共用体フィールド operation。変更オペレーション。operation は次のいずれかになります。
create

object (AdGroupAssetSet)

作成オペレーション: 新しい広告グループのアセットセットにリソース名は必要ありません。
remove

string

削除オペレーション: 削除された広告グループのアセットセットのリソース名が必要です。形式は customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id} です。

MutateAdGroupAssetSetResult

広告グループのアセットセットの変更の結果。

JSON 表現 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
フィールド
resourceName

string

オペレーションが成功した場合に返されます。
adGroupAssetSet

object (AdGroupAssetSet)

変更後に変更可能なフィールドのみを含む、変更された広告グループ アセットセット。このフィールドは、responseContentType が「MUTABLE_RESOURCE」に設定されている場合にのみ返されます。