Prima di iniziare
- Chiedi al rappresentante del tuo account di impostare le autorizzazioni appropriate per gli account a cui accede l'applicazione.
- Se non hai dimestichezza con i concetti di Authorized Buyers, visita il Centro assistenza Authorized Buyers e sperimenta con l'interfaccia utente. Se la tua applicazione dovrebbe eseguire offerte in tempo reale, leggi la documentazione sul protocollo RTB.
- Visita la console API per configurare un nuovo progetto. Accedi al tuo Account Google sviluppatore o crea un account. Ti verrà chiesto di creare un progetto e di accettare un paio di Termini di servizio.
Account principale e secondario
Se operi all'interno di una struttura di account contenente account principali e secondari, potresti essere in grado di lavorare in modo più efficace se comprendi come interagiscono. Ecco un breve riepilogo:
Account secondari
Un utente con credenziali che concedono l'accesso a un account secondario può solo visualizzare e modificare le risorse associate al proprio account. Gli account secondari non possono visualizzare o modificare le risorse appartenenti ad altri account secondari o principali.
Account genitore
Un utente con credenziali che concedono l'accesso a un account padre può visualizzare e modificare le risorse per l'account principale oltre a tutti gli account secondari associati. Per le operazioni che elencano l'intera risorsa, l'utente riceverà una risposta che include i dati del proprio account e di tutti gli account secondari. Tieni presente che per altri tipi di richieste che hanno come target le risorse per i clienti figlio, un
account principale dovrà specificare un parametro di percorso accountId
per l'account
figlio anziché il proprio accountId
.
Il modello dei dati dell'API REST
Una risorsa è una singola entità di dati con un identificatore univoco. La risorsa Account rappresenta una voce di account Authorized Buyers e la classe di dati radice per l'API Ad Exchange Buyers. I metodi dell'API operano su singole risorse di account e raccolte di risorse di account.
Una risorsa degli account include: un ID account, le informazioni utilizzate nella corrispondenza dei cookie, le località degli offerenti, l'URL a cui vengono inviate le richieste di offerta e una richiesta di specificare il numero massimo di query al secondo che possono essere inviate da Ad Exchange.
Oltre alla risorsa Account e alla raccolta, l'API Ad Exchange per gli acquirenti definisce le seguenti strutture di dati:
- Località offerente
Le località degli offerenti sono strutture che vengono restituite con Risorse dell'account per fornire l'URL a cui Ad Exchange deve inviare le richieste di offerta e il numero massimo di query al secondo che Ad Exchange deve inviare. Ecco un esempio di posizione dello strumento di offerta, espressa in JSON:
"bidderLocation": [ { "url": "http://bid.url.com/bidder", "maximumQps": 1500 } ],
- Elementi
Gli elementi forniscono un elenco di account. Ecco un esempio di elementi espressi in JSON:
{ "kind": "adexchangebuyer#accountsList", "items": [ accounts Resource ] }
Operazioni supportate
Puoi richiamare tre metodi diversi per le raccolte e le risorse nell'API Ad Exchange per gli acquirenti, come descritto nella seguente tabella. Tutte le operazioni richiedono l'autorizzazione.
Operazione | Descrizione | Mappature REST HTTP |
---|---|---|
list | Elenca tutti gli account a cui l'utente attualmente autenticato può accedere. | GET nell'URI di una raccolta. |
ricevi | Restituisce una risorsa Account specifica. | GET in un URI della risorsa. |
aggiornamento | Aggiorna una risorsa Account specifica. | PUT in un URI della risorsa, in cui passi i dati relativi alla risorsa aggiornata. |
Stile chiamata
REST è un tipo di architettura software che fornisce un approccio pratico e coerente per la richiesta e la modifica dei dati.
Il termine REST è l'acronimo di "REpresentational State Transfer". Nel contesto delle API di Google, si riferisce all'utilizzo dei verbi HTTP per recuperare e modificare le rappresentazioni dei dati archiviati da Google.
In un sistema RESTful, le risorse vengono archiviate in un datastore. Un client invia una richiesta affinché il server esegua una determinata azione (ad esempio la creazione, il recupero, l'aggiornamento o l'eliminazione di una risorsa) e il server esegue l'azione e invia una risposta, spesso sotto forma di rappresentazione della risorsa specificata.
Nelle API RESTful di Google, il client specifica un'azione utilizzando un verbo HTTP, come POST
, GET
, PUT
o DELETE
. Specifica una risorsa mediante un URI globalmente univoco nel seguente formato:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Poiché tutte le risorse dell'API dispongono di URI univoci accessibili tramite HTTP, REST consente la memorizzazione dei dati nella cache ed è ottimizzato per operare con l'infrastruttura distribuita del Web.
Potrebbero esserti utili le definizioni dei metodi riportate nella documentazione sugli standard HTTP 1.1, che includono specifiche per GET
, POST
, PUT
e DELETE
.
REST nell'API Ad Exchange per gli acquirenti
Le operazioni supportate corrispondono direttamente ai verbi HTTP REST, come descritto in Operazioni API.
Il formato specifico per gli URI delle API sono:
https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters
dove resourceID
è l'identificatore per una risorsa Account e parameters
sono parametri da applicare alla query. Per i dettagli, consulta i parametri di query standard e la documentazione di riferimento.
Il formato delle estensioni percorso resourceID
consente di identificare la risorsa su cui stai attualmente operando, ad esempio:
https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id
Il set completo di URI utilizzati per ogni operazione supportata nell'API è riassunto nella documentazione di riferimento.
Di seguito è riportato un esempio del funzionamento nell'API Ad Exchange per gli acquirenti.
Recupera l'elenco di account degli utenti autenticati:
GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts
Formato dei dati
JSON
JSON (JavaScript Object Notation) è un formato dati comune, indipendente dal linguaggio, che fornisce una semplice rappresentazione testuale di strutture di dati arbitrarie. Per ulteriori informazioni, visita il sito json.org.