Method: customers.adGroupAssetSets.mutate

创建或移除广告组素材资源组。系统会返回操作状态。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。要修改广告组素材资源组的客户的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "operations": [
    {
      object (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
字段
operations[]

object (AdGroupAssetSetOperation)

必需。要对各个广告组素材资源组执行的操作的列表。
partialFailure

boolean

如果为 true，系统会执行成功的操作，并针对无效的操作返回错误。如果为 false，则只有当所有操作都有效时，才会在一个事务中执行所有操作。默认值为 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 概览。

AdGroupAssetSetOperation

对广告组素材资源组执行的单次操作（创建、移除）。

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”时，系统才会返回该字段。