Method: customers.adGroupAssetSets.mutate

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

HTTP-запрос

POST https://googleads.googleapis.com/v14/customers/{customerId}/adGroupAssetSets:mutate

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

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

Параметры
customerId

string

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

Тело запроса

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

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

object ( AdGroupAssetSetOperation )

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

partialFailure

boolean

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

validateOnly

boolean

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

responseContentType

enum ( ResponseContentType )

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

Тело ответа

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

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

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

object ( MutateAdGroupAssetSetResult )

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

partialFailureError

object ( Status )

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

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

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

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

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

AdGroupAssetSetOperation

Одна операция (создание, удаление) с набором объектов группы объявлений.

JSON-представление
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Поля
Полевая operation Союза. Операция мутации. operation может быть только одной из следующих:
create

object ( AdGroupAssetSet )

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

remove

string

Операция удаления. Ожидается имя ресурса для удаленного набора объектов группы объявлений в следующем формате: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

Мутататеадграупассетсетрезультат

Результат изменения набора объектов группы объявлений.

JSON-представление
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
Поля
resourceName

string

Вернулся для успешных операций.

adGroupAssetSet

object ( AdGroupAssetSet )

Измененный набор объектов группы объявлений, в котором после изменения имеются только изменяемые поля. Поле будет возвращено только в том случае, если для параметра responseContentType установлено значение «MUTABLE_RESOURCE».