Method: customers.customerAssetSets.mutate

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
customerId

string

必須。顧客アセットセットが変更される顧客の ID。

リクエスト本文

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

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

object (CustomerAssetSetOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

レスポンスの本文

顧客アセット セットの mut に対するレスポンス メッセージです。

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

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

object (MutateCustomerAssetSetResult)

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

object (Status)

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

認可スコープ

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

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

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

CustomerAssetSetOperation

顧客アセットセットに対する単一のオペレーション（作成、削除）。

JSON 表現 
{

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

object (CustomerAssetSet)

作成オペレーション: 新規顧客アセットセットにリソース名は不要です。
remove

string

削除オペレーション: 削除された顧客アセットセットのリソース名は customers/{customerId}/customerAssetSets/{asset_set_id} の形式である必要があります。

MutateCustomerAssetSetResult

顧客アセットセットの結果が変わります。

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

string

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

object (CustomerAssetSet)

変更後の変更可能なフィールドのみを持つ、変更済みの顧客アセット セット。このフィールドは、responseContentType が「MUTABLE_RESOURCE」に設定されている場合にのみ返されます。