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 .