Method: advertisers.lineItems.generateDefault

Crea un nuovo elemento pubblicitario con le impostazioni (incluso il targeting) ereditate dall'ordine di inserzione e un ENTITY_STATUS_DRAFT entityStatus. 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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
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.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Se questo elemento pubblicitario pubblicherà annunci politici dell'Unione Europea.

Se containsEuPoliticalAds è stato impostato su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING nell'inserzionista principale, a questo campo verrà assegnato il valore DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING se non diversamente specificato. Questo campo può essere aggiornato utilizzando l'interfaccia utente, l'API o i file di dati strutturati.

Questo campo deve essere assegnato quando viene creato un nuovo elemento pubblicitario. In caso contrario, la richiesta advertisers.lineItems.create non andrà a buon fine.

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 OAuth 2.0 Overview.