Method: advertisers.lineItems.bulkUpdate

Обновляет несколько позиций.

Запросы к этой конечной точке не могут быть выполнены одновременно со следующими запросами, обновляющими ту же позицию:

Позиции YouTube и партнеров нельзя создавать или обновлять с помощью API.

HTTP-запрос

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate

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

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

Параметры
advertiserId

string ( int64 format)

Обязательно. Идентификатор рекламодателя, которому принадлежит эта позиция.

Текст запроса

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

JSON-представление 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
Поля
lineItemIds[]

string ( int64 format)

Обязательно. Идентификаторы позиций для обновления.

targetLineItem

object ( LineItem )

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

updateMask

string ( FieldMask format)

Обязательно. Маска поля, определяющая, какие поля необходимо обновить.

В настоящее время поддерживаются только следующие поля:

Это список полных имён полей, разделённых запятыми. Пример: "user.displayName,photo" .

Тело ответа

Ответное сообщение для LineItemService.BulkUpdateLineItems.

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

JSON-представление 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Поля
updatedLineItemIds[]

string ( int64 format)

Идентификаторы успешно обновленных позиций.

failedLineItemIds[]

string ( int64 format)

Идентификаторы позиций, которые не удалось обновить.

skippedLineItemIds[]

string ( int64 format)

Идентификаторы позиций, пропущенных при обновлении. Например, ненужные мутации, которые фактически не приведут к изменению позиций, будут пропущены, и соответствующие идентификаторы позиций можно отслеживать здесь.

errors[]

object ( Status )

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

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

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

  • https://www.googleapis.com/auth/display-video

Для получения более подробной информации см.OAuth 2.0 Overview .