Method: customers.campaignCriteria.mutate

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

抛出的错误列表：AdxError AuthenticationError AuthorizationError CampaignCriterionError CollectionSizeError ContextError CriterionError DatabaseError DistinctError FieldError FieldMaskError FunctionError HeaderError IdError InternalError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError OperatorError QuotaError RangeError RegionCodeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError

HTTP 请求

POST https://googleads.googleapis.com/v19/customers/{customerId}/campaignCriteria:mutate

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。要修改条件的客户的 ID。

请求正文

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

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

object (CampaignCriterionOperation)

必需。对各个条件执行的操作列表。
partialFailure

boolean

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

boolean

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

enum (ResponseContentType)

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

响应正文

广告系列条件更改的响应消息。

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

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

object (Status)

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

object (MutateCampaignCriterionResult)

更改的所有结果。

授权范围

需要以下 OAuth 范围：

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

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