Method: advertisers.lineItems.generateDefault

Crea una línea de pedido nueva con la configuración (incluida la segmentación) heredada del pedido de inserción y un ENTITY_STATUS_DRAFT entityStatus. Si la operación se realiza correctamente, devuelve la línea de pedido recién creada. Existen valores predeterminados basados en los tres campos:

Las líneas de pedido de YouTube & Partners no se pueden crear ni actualizar con la API.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
advertiserId

string (int64 format)

Obligatorio. Es el ID del anunciante al que pertenece esta línea de pedido.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Campos
insertionOrderId

string (int64 format)

Obligatorio. Es el ID único del pedido de inserción al que pertenece la línea de pedido.
displayName

string

Obligatorio. Es el nombre visible de la línea de pedido.

Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes.
lineItemType

enum (LineItemType)

Obligatorio. Es el tipo de línea de pedido.
mobileApp

object (MobileApp)

Es la app para dispositivos móviles que promociona la línea de pedido.

Esto solo se aplica cuando lineItemType es LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL o LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Indica si esta línea de pedido publicará anuncios políticos de la Unión Europea.

Si containsEuPoliticalAds se configuró como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING en la cuenta del anunciante principal, este campo se asignará como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING si no se especifica lo contrario. Luego, este campo se puede actualizar con la IU, la API o los archivos de datos estructurados.

Este campo se debe asignar cuando se crea una línea de pedido nueva. De lo contrario, la solicitud advertisers.lineItems.create fallará.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de LineItem.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.