Inizia a utilizzare l'API AdMob

Questa guida è rivolta agli sviluppatori che vogliono utilizzare l'API AdMob per ottenere in modo programmatico informazioni sul proprio account AdMob.

Tutte le chiamate API di Google AdMob devono essere autorizzate tramite OAuth2 in modo che 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 archiviare il nome utente o la password dell'utente. Per una panoramica dell'autorizzazione, consulta Autorizzazione.

Completa i seguenti passaggi per generare le credenziali OAuth2 ed effettuare la tua prima richiesta.

Prerequisiti

Determinare il tipo di autenticazione

Controlla la tabella di seguito per vedere quale tipo di autenticazione è più appropriato per la tua app:

Scegli il tipo di autenticazione OAuth2 Se ...
App desktop
  • Stai gestendo tutti i tuoi account API AdMob utilizzando un unico account amministratore di primo livello.
  • Se sei un nuovo utente o vuoi iniziare rapidamente con la configurazione più semplice.
  • L'app autentica gli utenti Google AdMob solo da un computer.
App web
  • Vuoi autenticarti come utente che può concedere alla tua app l'autorizzazione ad accedere ai dati del suo account dell'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.

Creare un progetto

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

Abilitazione dell'API per un progetto esistente

I passaggi seguenti si applicano agli utenti che hanno un progetto esistente e preferiscono attivare manualmente l'API AdMob per quel progetto.

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.

Crea credenziali OAuth2

Le seguenti istruzioni illustrano la procedura di creazione di un ID client OAuth 2.0 da utilizzare con il flusso dell'app installata.

  1. Go to the Credentials page.

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

    Se non hai mai configurato una schermata per il consenso OAuth per questo progetto, dovrai farlo ora. Fai clic su CONFIGURA SCHERMATA DI CONSENSO. Esistono diversi modi per configurare la schermata di consenso per utilizzare il tuo ID client OAuth 2.0.

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

    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 concedere loro l'accesso in modo che utilizzi il tuo ID client OAuth 2.0.

      Leggi ulteriori informazioni sulla configurazione della schermata per il consenso OAuth.

  3. Seleziona Applicazione desktop o Applicazione web come tipo di applicazione, assegnale un nome, poi fai clic su Crea.

Al termine, ti vengono presentati un ID client OAuth 2.0 e un client secret, che puoi scaricare in formato JSON e salvare per un uso successivo.

Fai una richiesta

L'API AdMob è basata su HTTP e JSON, pertanto qualsiasi client HTTP standard può inviare richieste e analizzare le risposte. Tuttavia, le librerie client delle API di Google offrono una migliore integrazione del linguaggio, una sicurezza migliorata e un supporto per l'esecuzione di richieste autorizzate. Le librerie client sono disponibili in vari linguaggi di programmazione; utilizzandole, si evita di dover impostare manualmente le richieste HTTP e analizzare le risposte.

Una volta create le credenziali OAuth 2.0, puoi iniziare a utilizzare l'API AdMob. Per richiedere l'accesso utilizzando OAuth 2.0, la tua app ha bisogno anche di informazioni sull'ambito:

Ambito Significato
https://www.googleapis.com/auth/admob.readonly Visualizzare tutti i dati AdMob. Questi dati possono includere dati dell'account, impostazioni dell'inventario e di mediazione, report e altri dati. 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 ID publisher, fuso orario e codice valuta predefinito.

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

Revoca token condivisi

Puoi revocare i token condivisi in due modi:

  1. Vai alla pagina delle autorizzazioni dell'Account Google e revoca l'accesso al progetto pertinente.

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