Method: advertisers.lineItems.generateDefault

Crea un nuovo elemento pubblicitario con le impostazioni (incluso il targeting) ereditate dall'ordine di inserzione e un entityStatus ENTITY_STATUS_DRAFT. Restituisce l'elemento pubblicitario appena creato in caso di esito positivo. Esistono valori predefiniti basati sui tre campi:

Gli elementi pubblicitari YouTube e partner non possono essere creati o aggiornati utilizzando l'API.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
advertiserId

string (int64 format)

Obbligatorio. L'ID dell'inserzionista a cui appartiene questo elemento pubblicitario.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
Campi
insertionOrderId

string (int64 format)

Obbligatorio. L'ID univoco dell'ordine di inserzione a cui appartiene l'elemento pubblicitario.
displayName

string

Obbligatorio. Il nome visualizzato dell'elemento pubblicitario.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.
lineItemType

enum (LineItemType)

Obbligatorio. Il tipo di elemento pubblicitario.
mobileApp

object (MobileApp)

L'app mobile promossa dall'elemento pubblicitario.

Questo vale solo quando lineItemType è LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL o LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di LineItem.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.