Method: customers.adGroupCriteria.mutate

Создает, обновляет или удаляет критерии. Статусы операций возвращаются.

Список выброшенных ошибок: AdGroupCriterionError AdxError AuthenticationError AuthorizationError BiddingError BiddingStrategyError CollectionSizeError ContextError CriterionError DatabaseError DateError DistinctError FieldError FieldMaskError HeaderError IdError InternalError MultiplierError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError ОператорError PolicyViolationError QuotaError RangeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError UrlFieldError

HTTP-запрос

POST https://googleads.googleapis.com/v15/customers/{customerId}/adGroupCriteria:mutate

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Необходимый. Идентификатор клиента, критерии которого изменяются.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "operations": [
    {
      object (AdGroupCriterionOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Поля
operations[]

object ( AdGroupCriterionOperation )

Необходимый. Список операций для выполнения по отдельным критериям.

partialFailure

boolean

Если это правда, будут выполнены успешные операции, а недопустимые операции вернут ошибки. Если false, все операции будут выполняться за одну транзакцию тогда и только тогда, когда все они действительны. По умолчанию — ложь.

validateOnly

boolean

Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты.

responseContentType

enum ( ResponseContentType )

Настройка типа контента ответа. Определяет, должен ли быть возвращен после мутации изменяемый ресурс или только имя ресурса.

Тело ответа

Ответное сообщение для изменения критерия группы объявлений.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAdGroupCriterionResult)
    }
  ]
}
Поля
partialFailureError

object ( Status )

Ошибки, относящиеся к сбоям работы в режиме частичного отказа. Возвращается только в том случае, если partialFailure = true и все ошибки происходят внутри операций. Если возникают какие-либо ошибки вне операций (например, ошибки аутентификации), мы возвращаем ошибку уровня RPC.

results[]

object ( MutateAdGroupCriterionResult )

Все результаты для mutate.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .