Domande frequenti

Generale

Qual è la versione più recente dell'API?

La versione più recente dell'API descritta in questo documento è v4.

Posso recuperare i dati sul rendimento utilizzando questa API?

No. Utilizza l'API Bid Manager per creare, recuperare ed eseguire i report offline di Display & Video 360.

Utilizzare l'API

Quale URL devo utilizzare per accedere all'API?

https://displayvideo.googleapis.com

Quali metodi di autenticazione sono supportati?

OAuth 2.0 è l'unico metodo di autenticazione supportato.

Le richieste all'API Display & Video 360 devono essere autorizzate per il seguente ambito:

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

Le richieste al servizio users devono essere autorizzate anche per il seguente ambito aggiuntivo:

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

Voglio scrivere codice. Dove posso trovare le librerie client?

Fai riferimento alla guida della libreria client.

Che cosa succede se non voglio utilizzare una libreria client?

Ti consigliamo di utilizzare una delle nostre librerie client, ma puoi anche interagire con l'API Display & Video 360 utilizzando richieste HTTP dirette.

Alcuni metodi più complessi, come advertisers.assets.upload e media.upload, sono più difficili da tradurre direttamente in richieste HTTP. Consulta gli esempi di richieste HTTP a questi metodi utilizzando cURL nelle nostre guide su creatività e asta personalizzata.

Quali autorizzazioni Display & Video 360 mi occorrono?

Per poter utilizzare l'API Display & Video 360, l'Account Google che esegue l'autenticazione deve essere un utente di Display & Video 360 con accesso a partner o inserzionisti pertinenti.

L'utente Display & Video 360 deve disporre di uno dei seguenti ruoli utente per consentire ai partner o agli inserzionisti pertinenti di svolgere le seguenti azioni:

• Sola lettura: recupera le risorse utilizzando le chiamate get o list, escluse le risorse user.
• Standard: recupera, crea e aggiorna le risorse. Recupera le risorse user con autorizzazioni per gli stessi partner o inserzionisti.
• Amministratore: recupera, crea e aggiorna le risorse. Recupera, crea e concedi accesso alle risorse user per i partner o gli inserzionisti che amministri.

Come faccio ad aggiornare le risorse di YouTube e dei partner utilizzando l'API?

L'API Display & Video 360 non supporta la creazione o l'aggiornamento delle risorse di YouTube e dei partner. Crea o aggiorna collettivamente le risorse YouTube e partner caricando file di dati strutturati (SDF) nell'interfaccia di Display & Video 360. Per maggiori dettagli su come utilizzare il caricamento SDF, consulta la nostra pagina di guida sulle risorse di YouTube e dei partner.

Come faccio a scegliere come target località geografiche?

Il targeting geografico può essere assegnato agli elementi pubblicitari utilizzando i seguenti tipi di targeting:

• TARGETING_TYPE_GEO_REGION
• TARGETING_TYPE_POI
• TARGETING_TYPE_BUSINESS_CHAIN
• TARGETING_TYPE_REGIONAL_LOCATION_LIST
• TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Recupera gli ID opzione di targeting per i primi tre tipi di targeting utilizzando targetingTypes.targetingOptions.search. Recupera e gestisci le risorse degli elenchi di località utilizzando il servizio advertisers.locationLists.

Inoltre, puoi anche creare un ID TARGETING_TYPE_POI per un'opzione di targeting per scegliere come target direttamente un raggio di prossimità intorno a coordinate di latitudine e longitudine specifiche.

Mi risulta che posso scaricare i file di dati strutturati (SDF) utilizzando l'API, ma come faccio a caricarli?

L'API Display & Video 360 non supporta il caricamento di file SDF. Ti consigliamo di gestire le risorse tramite i metodi CREATE, PATCH e DELETE forniti dall'API. Se vuoi comunque gestire le risorse utilizzando gli SDF, questi file possono essere aggiornati nell'interfaccia di Display & Video 360.

Assistenza

L'API presenta problemi o limitazioni noti?

Esistono limiti al numero di richieste che il progetto può effettuare al secondo, che sono descritti nella nostra guida ai limiti di utilizzo.