- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- AdGroupAssetSetOperation
- MutateAdGroupAssetSetResult
- 試してみる
広告グループのアセットセットを作成、削除します。オペレーションのステータスが返されます。
HTTP リクエスト
POST https://googleads.googleapis.com/v15/customers/{customerId}/adGroupAssetSets:mutate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
customerId |
必須。広告グループのアセットセットが変更される顧客の ID。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "operations": [ { object ( |
フィールド | |
---|---|
operations[] |
必須。個々の広告グループのアセットセットに対して行う処理のリストです。 |
partialFailure |
true の場合、成功したオペレーションが実行され、無効なオペレーションはエラーを返します。false の場合、すべての操作が有効である場合にのみ、すべての操作が 1 つのトランザクションで実行されます。デフォルトは false です。 |
validateOnly |
true の場合、リクエストは検証されますが、実行されません。エラーのみが返され、結果は返されません。 |
responseContentType |
レスポンスのコンテンツ タイプの設定。ミューテーション後に可変リソースを返すか、リソース名のみを返すかを決定します。 |
レスポンスの本文
広告グループのアセットセットの mut に対するレスポンス メッセージです。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "results": [ { object ( |
フィールド | |
---|---|
results[] |
ミューテーションのすべての結果。 |
partialFailureError |
部分障害モードのオペレーションの失敗に関連するエラー。partialFailure が true で、オペレーション内ですべてのエラーが発生した場合にのみ返されます。オペレーションの外部でエラー(認証エラーなど)が発生した場合は、RPC レベルのエラーが返されます。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/adwords
詳細については、OAuth 2.0 の概要をご覧ください。
AdGroupAssetSetOperation
広告グループのアセットセットに対する 1 回の操作(作成、削除)です。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド operation 。mute オペレーションです。operation は次のいずれかになります。 |
|
create |
作成操作: 新しい広告グループのアセットセットにリソース名は必要ありません。 |
remove |
削除操作: 削除された広告グループのアセットセットにはリソース名が必要です。形式は |
MutateAdGroupAssetSetResult
広告グループのアセットセットの結果が変わります。
JSON 表現 |
---|
{
"resourceName": string,
"adGroupAssetSet": {
object ( |
フィールド | |
---|---|
resourceName |
成功したオペレーションに対して返されます。 |
adGroupAssetSet |
変換後に変更可能なフィールドのみを持つ、変換後の広告グループのアセットセットです。このフィールドは、responseContentType が「MUTABLE_RESOURCE」に設定されている場合にのみ返されます。 |