Method: customers.feedItems.mutate

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

Список выброшенных ошибок: AuthenticationError AuthorizationError CollectionSizeError CriterionError DatabaseError DateError DistinctError FeedItemError FieldError FieldMaskError HeaderError IdError InternalError ListOperationError MutateError NotEmptyError NullError OperationError QuotaError RangeError RequestError SizeLimitError StringFormatError StringLengthError UrlFieldError

HTTP-запрос

POST https://googleads.googleapis.com/v16/customers/{customerId}/feedItems:mutate

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

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

Параметры
customer Id

string

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

Тело запроса

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

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

object ( FeedItemOperation )

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

partial Failure

boolean

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

validate Only

boolean

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

response Content Type

enum ( ResponseContentType )

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

Тело ответа

Ответное сообщение для изменения элемента фида.

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

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

object ( Status )

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

results[]

object ( MutateFeedItemResult )

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

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

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

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

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

,

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

Список выброшенных ошибок: AuthenticationError AuthorizationError CollectionSizeError CriterionError DatabaseError DateError DistinctError FeedItemError FieldError FieldMaskError HeaderError IdError InternalError ListOperationError MutateError NotEmptyError NullError OperationError QuotaError RangeError RequestError SizeLimitError StringFormatError StringLengthError UrlFieldError

HTTP-запрос

POST https://googleads.googleapis.com/v16/customers/{customerId}/feedItems:mutate

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

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

Параметры
customer Id

string

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

Тело запроса

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

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

object ( FeedItemOperation )

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

partial Failure

boolean

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

validate Only

boolean

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

response Content Type

enum ( ResponseContentType )

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

Тело ответа

Ответное сообщение для изменения элемента фида.

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

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

object ( Status )

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

results[]

object ( MutateFeedItemResult )

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

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

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

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

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