Iniziare a utilizzare l'API AdMob

Importante: i nuovi ruoli e le nuove autorizzazioni utente influiranno sui dati restituiti dall'API AdMob. Scopri di più

Questa guida è rivolta agli sviluppatori che vogliono utilizzare l'API AdMob per recuperare in modo programmatico i dati nel proprio account AdMob.

Tutte le chiamate all'API Google AdMob devono essere autorizzate tramite OAuth2 affinché la tua app possa interagire con i servizi web per conto dell'utente. OAuth2 consente all'app client dell'API AdMob di accedere all'account AdMob di un utente senza dover gestire o memorizzare il nome utente o la password dell'utente. Per una panoramica dell'autorizzazione, consulta Autorizzazione.

Per generare le credenziali OAuth2 ed effettuare la prima richiesta, segui i passaggi che seguono.

Prerequisiti

• Un Account Google.

• Un account Google AdMob.

• Conoscenza delle nozioni di base di REST e dell'autorizzazione delle richieste con OAuth 2.0.

Determinare il tipo di autenticazione

Consulta la tabella seguente per scoprire quale tipo di autenticazione è più adatto per la tua app:

Scegliere il tipo di autenticazione OAuth2	Se…
App desktop	Gestisci tutti i tuoi account API AdMob utilizzando un unico account amministratore di primo livello. Sei un utente alle prime armi o vuoi iniziare rapidamente con la configurazione più semplice. La tua app autentica gli utenti di Google AdMob solo da un computer.
App web	Vuoi autenticarti come utente che può concedere alla tua app l'autorizzazione per accedere ai dati del proprio account API AdMob. Vuoi generare facilmente più credenziali di autorizzazione, ad esempio per gestire account di terze parti. La tua app richiede URL di callback. Gli URL di callback non sono supportati nel flusso dell'app desktop.

Punto chiave: puoi comunque scegliere il flusso dell'app desktop anche se stai sviluppando un'app da eseguire su un server. La differenza sta nel fatto che l'autorizzazione OAuth viene completata localmente o da remoto. Un flusso da computer richiede che l'autorizzazione venga completata sulla macchina locale, mentre il flusso web consente di completare l'autorizzazione sul server di autorizzazione di Google.

Crea un progetto

Per iniziare a utilizzare l'API AdMob, devi prima creare o selezionare un progetto nella console API di Google e attivare l'API utilizzando lo strumento di configurazione, che ti guida nella procedura e attiva automaticamente l'API AdMob.

Attivazione dell'API per un progetto esistente

I passaggi che seguono si applicano agli utenti che hanno già un progetto e preferiscono attivare manualmente l'API AdMob.

Per abilitare un'API per il tuo progetto:

1. Open the API Library in Google API Console .
2. If prompted, select a project, or create a new one. API Library elenca tutte le API disponibili, raggruppate per famiglia di prodotti e popolarità.
3. Se l'API che si desidera abilitare non è visibile nell'elenco, utilizzare la ricerca per trovarla oppure fare clic su Visualizza tutto nella famiglia di prodotti a cui appartiene.
4. Seleziona l'API che desideri abilitare, quindi fai clic sul pulsante Abilita .
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

Creare le credenziali OAuth2

Le istruzioni riportate di seguito descrivono la procedura per creare un ID client OAuth 2.0 da utilizzare con il flusso per le app installate.

1. Go to the Credentials page.

2. Fai clic su CREA CREDENZIALI > ID client OAuth.

   Se non hai ancora configurato una schermata per il consenso OAuth per questo progetto, ti verrà chiesto di farlo ora. Fai clic su CONFIGURA SCHERMATA DI CONSENSO. Esistono diversi modi per configurare la schermata per il consenso in modo da utilizzare il tuo ID client OAuth 2.0.

   1. Imposta il tipo di utente su Esterno e lo stato di pubblicazione su Pubblicato.

   2. In alternativa, imposta il tipo di utente su Esterno e lo stato di pubblicazione su Test, quindi aggiungi Utenti di test selezionando Aggiungi utenti per dare loro l'accesso per utilizzare il tuo ID client OAuth 2.0.

      Scopri di più sulla configurazione della schermata di consenso OAuth.

3. Seleziona App desktop o Applicazione web come tipo di applicazione, assegna un nome e fai clic su Crea.

Al termine, ti verranno mostrati un ID client e un segreto client OAuth 2.0, che puoi scaricare in formato JSON e salvare per un uso futuro.

Fai una richiesta

L'API AdMob si basa su HTTP e JSON, pertanto qualsiasi client HTTP standard può inviare richieste e analizzare le risposte. Tuttavia, le librerie client dell'API di Google offrono una migliore integrazione del linguaggio, una maggiore sicurezza e supporto per effettuare richieste autorizzate. Le librerie client sono disponibili in più linguaggi di programmazione; utilizzandole puoi evitare di dover impostare le richieste HTTP e analizzare le risposte manualmente.

Nota: la prima volta che attivi il flusso OAuth, ti viene chiesto di fornire il tuo ID publisher AdMob e di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso al tuo account AdMob. L'app è quindi autorizzata ad accedere ai dati per conto di qualunque account sia attualmente collegato.

Dopo aver creato le credenziali OAuth 2.0, puoi iniziare a utilizzare l'API AdMob. Per richiedere l'accesso utilizzando OAuth 2.0, la tua app richiede anche informazioni sull'ambito:

Ambito	Significato
https://www.googleapis.com/auth/admob.readonly	Visualizzare tutti i dati di AdMob. Questi dati includono quelli dell'account, le impostazioni dell'inventario e di mediazione, i report e altro ancora. Non sono inclusi dati sensibili, come i dettagli sui pagamenti o sulle campagne.
https://www.googleapis.com/auth/admob.report	Visualizzare i report sul rendimento degli annunci e sugli utili. Visualizza l'ID, il fuso orario e il codice valuta predefinito del publisher.

Invia la tua prima richiesta per generare un report utilizzando esempi in Java, PHP, Python o curl.

Revocare i token condivisi

Puoi revocare i token condivisi in due modi:

1. Vai alla pagina delle autorizzazioni del tuo Account Google e revoca l'accesso dal progetto pertinente.

2. In alternativa, puoi revocare i token delle applicazioni web utilizzando l'API Google Identity.