Configurare e utilizzare OAuth

Tutte le chiamate all'API Local Services devono essere autorizzate tramite OAuth 2.0. In questo modo, l'app client API Local Services può accedere all'account annunci di Servizi locali di un utente senza dover gestire o archiviare i dati di accesso dell'utente.

L'API Local Services utilizza il protocollo OAuth 2.0 per autenticare gli utenti. Per scoprire di più su OAuth 2.0, consulta l'articolo Utilizzare OAuth 2.0 per accedere alle API di Google.

Configurare un progetto della console API di Google per l'API Local Services

Per autenticare e autorizzare gli utenti Google Ads, devi disporre delle credenziali per accedere ai server OAuth 2.0 di Google. Queste credenziali identificano la tua applicazione per Google e ti consentono di generare token OAuth per gestire gli utenti Google Ads. Utilizza la console API di Google per gestire l'accesso alle tue credenziali Google OAuth 2.0.

Per ricevere queste credenziali, segui questi passaggi:

  1. Creare un progetto. Per farlo, vai alla console dell'API di Google. Fai clic su Crea progetto, inserisci un nome e fai clic su Crea.

  2. Abilita l'API Local Services nel tuo progetto:

    1. Apri la libreria API nella console API di Google. Se richiesto, seleziona il progetto o creane uno nuovo. La libreria API elenca tutte le API disponibili, raggruppate per famiglia di prodotti e popolarità.

      Se l'API Local Services non è visibile nell'elenco, utilizza la casella di ricerca per trovarla.

    2. Seleziona l'API Local Services, quindi fai clic su Abilita.

  3. Scegli un tipo di app. L'API Servizi locali utilizza gli stessi tipi di app dell'API Google Ads. Per ulteriori dettagli su quale tipo di app utilizzare, consulta Scegliere un tipo di app.

  4. Crea un ID client e un client secret. Per l'API Local Services, segui gli stessi passaggi per creare un ID client e un secret client utilizzati per l'API Google Ads. I passaggi sono identici per entrambi i casi d'uso.

Utilizzare la libreria client per ottenere token OAuth 2.0

Per un elenco delle librerie client che puoi utilizzare per effettuare richieste di autorizzazione OAuth 2.0, consulta la sezione Librerie client. Segui le istruzioni specifiche della libreria per scoprire come utilizzare un token di aggiornamento per ottenere un nuovo token di accesso.

Come ottenere un token di aggiornamento OAuth 2.0

Ti consigliamo di utilizzare le librerie client in produzione per autenticare gli utenti. Se vuoi utilizzare un client HTTP a scopo di test, segui queste istruzioni per ottenere un token di aggiornamento OAuth 2.0 e un token di accesso. I passaggi 1, 2 e 3 sono istruzioni di configurazione una tantum che devi eseguire manualmente, mentre i passaggi 4 e 5 possono essere automatizzati in seguito per essere eseguiti senza intervento umano, ad esempio un cron job.

  1. Scarica e installa curl, uno strumento a riga di comando per effettuare richieste web HTTP.

  2. Segui le istruzioni riportate nella pagina OAuth Playground per ottenere un token di aggiornamento OAuth 2.0. Utilizza il seguente ambito per l'API Local Services:

    https://www.googleapis.com/auth/adwords

    Si tratta dello stesso ambito OAuth 2.0 utilizzato dall'API Google Ads.

    Al termine di questo passaggio, riceverai due token: un token di aggiornamento e un token di accesso. Salvali entrambi.

  3. Esegui questo comando in un prompt dei comandi per verificare che il passaggio precedente sia andato a buon fine:

    curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>

    Se l'output del comando mostra un messaggio simile al seguente, l'operazione è riuscita:

    {
  "azp": "************-********************************.apps.googleusercontent.com",
  "aud": "************-********************************.apps.googleusercontent.com",
  "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]",
  "exp": "1611183382",
  "expires_in": "3482",
  "access_type": "offline"
}

    Se si verifica un errore o l'ambito non è corretto, prova a generare di nuovo i token.

  4. Genera un nuovo token di accesso senza intervento manuale. Questo è importante perché i token di accesso scadono ogni ora. I token di aggiornamento impiegano molto più tempo a scadere, quindi spesso devi revocarli manualmente quando non sono più necessari.

    Per ottenere un nuovo token di accesso, esegui questo comando:

    curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”

  5. Esegui la seguente chiamata API:

    curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>

    Se la chiamata va a buon fine, la configurazione è completata.