Создает, обновляет или удаляет группы объявлений. Статусы операций возвращаются.
Список выброшенных ошибок: AdGroupError AdxError AuthenticationError AuthorizationError BiddingError BiddingStrategyError DatabaseError DateError DistinctError FieldError FieldMaskError HeaderError IdError InternalError ListOperationError MultiplierError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError ОператорError QuotaError RangeError RequestError ResourceCountLimitExceededError SettingError SizeLimitError StringFormatError StringL engthError UrlFieldError
HTTP-запрос
POST https://googleads.googleapis.com/v14/customers/{customerId}/adGroups:mutate
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента, группы объявлений которого изменяются. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "operations": [ { object ( |
Поля | |
---|---|
operations[] | Необходимый. Список операций, которые необходимо выполнить над отдельными группами объявлений. |
partialFailure | Если это правда, будут выполнены успешные операции, а недопустимые операции вернут ошибки. Если false, все операции будут выполняться за одну транзакцию тогда и только тогда, когда все они действительны. По умолчанию — ложь. |
validateOnly | Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты. |
responseContentType | Настройка типа контента ответа. Определяет, должен ли быть возвращен после мутации изменяемый ресурс или только имя ресурса. |
Тело ответа
Ответное сообщение для изменения группы объявлений.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "partialFailureError": { object ( |
Поля | |
---|---|
partialFailureError | Ошибки, относящиеся к сбоям работы в режиме частичного отказа. Возвращается только в том случае, если partialFailure = true и все ошибки происходят внутри операций. Если возникают какие-либо ошибки вне операций (например, ошибки аутентификации), мы возвращаем ошибку уровня RPC. |
results[] | Все результаты для mutate. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .