Prima di poter iniziare la codifica della tua prima applicazione client, è necessario eseguire alcune operazioni, qualora non lo avessi già fatto.
Crea un account Google
Per creare un progetto nella console API di Google devi avere un Account Google. Se hai già un account, non devi fare altro.
Ti consigliamo anche di creare un Account Google separato a scopo di test.
Prova Google AdMob
Questa documentazione dell'API presuppone che tu abbia utilizzato Google AdMob e che tu conosca i concetti di programmazione web e i formati dei dati web.
Se non hai ancora utilizzato Google AdMob, prova l'interfaccia utente prima di iniziare a programmare.
Creare un progetto per il client
Prima di poter inviare richieste a Google AdMob, devi informare Google del tuo cliente e attivare l'accesso all'API. Per farlo, puoi utilizzare la console API di Google per creare un progetto, ovvero una raccolta denominata di impostazioni e informazioni sull'accesso all'API, per registrare la tua applicazione.
Per iniziare a utilizzare l'API AdMob, devi prima utilizzare lo strumento di configurazione, che ti guida nella creazione di un progetto nella console API di Google, nell'attivazione dell'API e nella creazione delle credenziali.
Apprendere 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 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 AdMob
Le operazioni dell'API AdMob vengono mappate direttamente ai verbi HTTP REST.
I formati specifici per gli URI dell'API AdMob sono:
https://admob.googleapis.com/v1/resourcePath?parameters
Il set completo di URI utilizzati per ogni operazione supportata nell'API è riassunto nel documento di riferimento sull'API AdMob.
Apprendere le nozioni di base di JSON
L'API AdMob restituisce i dati in formato 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.