Method: advertisers.lineItems.generateDefault

Создает новую позицию с настройками (включая таргетинг), унаследованными от заказа на размещение entityStatus и ENTITY_STATUS_DRAFT . В случае успеха возвращает вновь созданную позицию. Существуют значения по умолчанию, основанные на трех полях:

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

HTTP-запрос

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

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

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

Параметры
advertiserId

string ( int64 format)

Необходимый. Идентификатор рекламодателя, которому принадлежит эта позиция.

Тело запроса

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

JSON-представление
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
Поля
insertionOrderId

string ( int64 format)

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

displayName

string

Необходимый. Отображаемое название позиции.

Должен быть в кодировке UTF-8 с максимальным размером 240 байт.

lineItemType

enum ( LineItemType )

Необходимый. Тип позиции.

mobileApp

object ( MobileApp )

Мобильное приложение, рекламируемое позицией.

Это применимо только в том случае, если lineItemType имеет значение LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL или LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL .

Тело ответа

В случае успеха тело ответа содержит экземпляр LineItem .

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

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

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

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