Создает, обновляет или удаляет кампании. Статусы операций возвращаются.
Список выброшенных ошибок: AdxError AuthenticationError AuthorizationError BiddingError BiddingStrategyError CampaignBudgetError CampaignError ContextError DatabaseError DateError DateRangeError DistinctError FieldError FieldMaskError HeaderError IdError InternalError ListOperationError MutateError NewResourceCreationError NotAllowlistedError NotEmptyError NullError OperationAccessDeniedError ОператорError QuotaError RangeError RegionCodeError RequestError ResourceCountLimit ExceededError SettingError SizeLimitError StringFormatError StringLengthError UrlFieldError
HTTP-запрос
POST https://googleads.googleapis.com/v14/customers/{customerId}/campaigns: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 .