Method: advertisers.lineItems.bulkUpdate

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

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

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

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

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

Параметры
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.