Method: advertisers.lineItems.generateDefault

Crea una nueva línea de pedido con una configuración (incluida la segmentación) heredada del pedido de inserción y una entityStatus con ENTITY_STATUS_DRAFT. Muestra la línea de pedido recién creada si se creó correctamente. Hay 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/v3/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. Indica 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)
  }
}
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. 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. El tipo de línea de pedido.

mobileApp

object (MobileApp)

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

Esto es aplicable solo cuando lineItemType es LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL o LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

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 alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.