Generale
Qual è la versione più recente dell'API?
La versione più recente dell'API a cui indirizza questo documento è v3.
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 API di 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?
Consulta la guida sulla 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ù coinvolti, come advertisers.assets.upload
e media.upload, sono più difficili da tradurre direttamente in richieste
HTTP. Consulta esempi di richieste HTTP a questi metodi utilizzando cURL nelle nostre guide Creatività e Offerte personalizzate.
Quali autorizzazioni di Display & Video 360 sono necessarie?
Per utilizzare l'API Display & Video 360, l'Account Google che esegue l'autenticazione deve essere un utente di Display & Video 360 con accesso ai partner o agli inserzionisti pertinenti.
L'utente di Display & Video 360 deve disporre di uno dei seguenti ruoli utente affinché i partner o gli inserzionisti pertinenti possano eseguire le seguenti azioni:
- Sola lettura: recupera le risorse utilizzando le chiamate
getolist, escluse le risorseuser. - Standard: recupera, crea e aggiorna risorse. Recupera risorse
usercon autorizzazioni per gli stessi partner o inserzionisti. - Amministratore: recupera, crea e aggiorna risorse. Recupera, crea e concedi l'accesso alle risorse
userper i partner o gli inserzionisti che amministri.
Come faccio ad aggiornare le risorse di YouTube e partner utilizzando l'API?
L'API Display & Video 360 non supporta la creazione o l'aggiornamento delle risorse YouTube e partner. Crea o aggiorna collettivamente le risorse YouTube e partner caricando file di dati strutturati (SDF) nell'interfaccia di Display & Video 360. Per ulteriori dettagli su come utilizzare il caricamento dei file SDF, leggi la nostra pagina della guida relativa alle risorse di YouTube e partner.
Come faccio a impostare il targeting per località geografiche?
Il targeting geografico può essere assegnato agli elementi pubblicitari utilizzando i seguenti tipi di targeting:
TARGETING_TYPE_GEO_REGIONTARGETING_TYPE_POITARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_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 dell'elenco delle località utilizzando il servizio advertisers.locationLists.
Inoltre, puoi anche creare un ID opzione di targeting TARGETING_TYPE_POI per scegliere come target direttamente un raggio di prossimità intorno a coordinate di latitudine e longitudine specifiche.
Posso scaricare file di dati strutturati (SDF) usando l'API, ma come faccio a caricarli?
L'API Display & Video 360 non supporta il caricamento dei file SDF. Ti consigliamo di gestire le risorse tramite i metodi CREATE, PATCH e DELETE forniti dall'API. Se vuoi continuare a gestire le risorse utilizzando i file SDF, puoi aggiornare questi file nell'interfaccia di Display & Video 360.
Assistenza
L'API presenta problemi o limitazioni noti?
Esistono dei limiti al numero di richieste che il tuo progetto può effettuare al secondo, come descritto nella nostra guida ai limiti di utilizzo.