Method: customers.adGroupAds.mutate

创建、更新或移除广告。系统会返回操作状态。

抛出的错误列表：AdCustomizerError AdError AdGroupAdError AdSharingError AdxError AssetError AssetLinkError AuthenticationError AuthorizationError CollectionSizeError ContextError DatabaseError DateError DistinctError FeedAttributeReferenceError FieldError FieldMaskError FunctionError FunctionParsingError HeaderError IdError ImageError InternalError ListOperationError MediaBundleError MediaFileError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError OperatorError PolicyFindingError PolicyValidationParameterError PolicyViolationError QuotaError RangeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError UrlFieldError

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。要修改其广告的客户的 ID。

请求正文

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

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

object (AdGroupAdOperation)

必需。对各个广告执行的操作列表。
partialFailure

boolean

如果为 true，系统会执行成功的操作，并针对无效的操作返回错误。如果为 false，则只有当所有操作都有效时，才会在一个事务中执行所有操作。默认值为 false。
validateOnly

boolean

如果为 true，则系统会验证该请求，但不会执行该请求。仅返回错误，不返回结果。
responseContentType

enum (ResponseContentType)

响应内容类型设置。确定在变更后返回可变资源还是仅返回资源名称。

响应正文

广告组广告转变的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAdGroupAdResult)
    }
  ]
}
字段
partialFailureError

object (Status)

与部分失败模式下的操作失败相关的错误。仅当 partialFailure = true 并且所有错误都发生在操作内部时，才会返回。如果在操作之外发生任何错误（例如，身份验证错误），我们将返回 RPC 级别的错误。
results[]

object (MutateAdGroupAdResult)

该转变的所有结果。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 概览。