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. Devuelve la línea de pedido recién creada si se realiza correctamente. Existen valores predeterminados basados en los tres campos:

No se pueden crear ni actualizar líneas de pedido de YouTube y socios 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. 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)
  }
}
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 aplicación 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.

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.