Method: advertisers.lineItems.generateDefault

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

Создавать или обновлять позиции в разделе «YouTube и партнеры» с помощью API невозможно.

HTTP-запрос

POST https://displayvideo.googleapis.com/v4/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 .