Prima di poter iniziare la codifica della tua prima applicazione client, è necessario eseguire alcune operazioni, qualora non lo avessi già fatto.
Come procurarsi un account Google
Per creare un progetto nella console API di Google, devi avere un Account Google. Se hai già un account, è tutto pronto.
Ti consigliamo anche di disporre di un Account Google separato per i test.
Prova il report Esperienza pubblicitaria di Google
Questa documentazione dell'API presuppone che tu abbia utilizzato il report Esperienza pubblicitaria di Google e che tu abbia familiarità con i concetti di programmazione web e con i formati dei dati web.
Se non hai utilizzato il report Esperienza pubblicitaria di Google, prova l'interfaccia utente prima di iniziare a scrivere il codice.
Creare un progetto per il client
Prima di poter inviare richieste al report sull'esperienza pubblicitaria di Google, devi comunicare a Google il tuo client e attivare l'accesso all'API. A tale scopo, utilizza la console API di Google per creare un progetto, ovvero una raccolta denominata di impostazioni e informazioni relative all'accesso all'API, e registra la tua applicazione.
Apprendere le nozioni di base di REST
Esistono due modi per richiamare l'API:
- Inviare richieste HTTP e analizzarne le risposte.
- Utilizzare le librerie client.
Se decidi di non utilizzare le librerie client, è necessario che tu conosca le nozioni di base di REST.
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 mediante un verbo HTTP come POST, GET, PUT o DELETE. La risorsa viene specificata tramite un URI globalmente univoco con il 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 degli standard HTTP 1.1, in cui sono incluse le specifiche per i metodi GET, POST, PUT e DELETE.
REST nell'API Google Ad Experience Report
Le operazioni dell'API Rapporto Esperienza pubblicitaria di Google corrispondono direttamente ai verbi HTTP in REST.
I formati specifici per gli URI dell'API Google Ad Experience Report sono:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
Il set completo di URI utilizzati per ogni operazione supportata nell'API è riepilogato nel documento Riferimento API Rapporto Esperienza pubblicitaria di Google.
Apprendere le nozioni di base di JSON
L'API Google Ad Experience Report restituisce i dati in formato JSON.
JSON (JavaScript Object Notation) è un formato di dati comune, indipendente dal linguaggio, che fornisce una semplice rappresentazione testuale di strutture arbitrarie di dati. Per ulteriori informazioni, visita il sito json.org.