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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Поля
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 .

containsEuPoliticalAds

enum ( EuPoliticalAdvertisingStatus )

Будет ли эта позиция показывать политическую рекламу Европейского Союза.

Если для свойства containsEuPoliticalAds в родительском рекламодателе задано значение DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING , то этому полю будет присвоено значение DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING если не указано иное. Это поле можно обновить через пользовательский интерфейс, API или файлы структурированных данных.

Это поле необходимо задать при создании новой позиции. В противном случае запрос advertisers.lineItems.create завершится ошибкой .

Тело ответа

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

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

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

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

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