API User Deletion - Autorizzazione

Questa guida descrive in che modo un'applicazione autorizza le richieste all'API User Deletion.

Autorizzazione delle richieste

Prima di poter visualizzare le informazioni del proprio account sul sito web di Google Analytics, gli utenti devono eseguire l'accesso al proprio account Google. Allo stesso modo, quando gli utenti accedono per la prima volta alla tua applicazione, devono autorizzarla ad accedere ai loro dati.

Ogni richiesta che la tua applicazione invia all'API Analytics deve includere un token di autorizzazione. Il token, inoltre, identifica l'applicazione per Google.

Informazioni sui protocolli di autorizzazione

La tua applicazione deve utilizzare il protocollo OAuth 2.0 per autorizzare le richieste. Non sono supportati altri protocolli di autorizzazione. Se la tua applicazione utilizza la funzionalità Accedi con Google, alcuni aspetti dell'autorizzazione vengono gestiti per te.

Autorizzazione delle richieste con OAuth 2.0

Tutte le richieste all'API Analytics devono essere autorizzate da un utente autenticato.

I dettagli della procedura di autorizzazione, o "flusso", per il protocollo OAuth 2.0 variano a seconda del tipo di applicazione che stai scrivendo. La seguente procedura generale si applica a tutti i tipi di applicazione:

  1. Quando crei la tua applicazione, la registri utilizzando la console API di Google. Quindi, Google fornisce informazioni che ti saranno necessarie in un secondo momento, ad esempio un ID client e un client secret.
  2. Attiva l'API Analytics nella console API di Google. (Se l'API non è elencata nella console API, salta questo passaggio.)
  3. Quando la tua applicazione vuole accedere ai dati dell'utente, chiede a Google un particolare ambito di accesso.
  4. Google mostra una schermata di consenso all'utente, chiedendo di autorizzare l'applicazione a richiedere dei dati.
  5. Se l'utente approva, Google fornisce alla tua applicazione un token di accesso di breve durata.
  6. L'applicazione richiede i dati utente, allegando il token di accesso alla richiesta.
  7. Se Google ritiene validi la richiesta e il token, restituisce i dati richiesti.

Alcuni flussi includono passaggi aggiuntivi, come l'uso di token di aggiornamento per acquisire nuovi token di accesso. Per informazioni dettagliate sui flussi per vari tipi di applicazioni, consulta la documentazione relativa al protocollo OAuth 2.0 di Google.

Ecco le informazioni relative all'ambito OAuth 2.0 per l'API Analytics:

Ambito Significato
https://www.googleapis.com/auth/analytics.user.deletion Elimina i dati utilizzando l'API User Deletion.

Per richiedere l'accesso utilizzando il protocollo OAuth 2.0, l'applicazione richiede le informazioni relative all'ambito e le informazioni che Google fornisce quando registri la tua applicazione (ad esempio l'ID client e il client secret).

Suggerimento: le librerie client delle API di Google possono gestire parte del processo di autorizzazione per te. Sono disponibili per una varietà di linguaggi di programmazione; consulta la pagina delle librerie e dei campioni per maggiori dettagli.

Flussi OAuth 2.0 comuni

Di seguito sono elencati i casi d'uso comuni per flussi OAuth 2.0 specifici:

Server web

Questo flusso è utile per l'accesso automatico, offline o pianificato ai dati di Google Analytics di un utente.

Esempio:

  • Aggiornamento automatico delle dashboard utente con i dati più recenti di Google Analytics.

Lato client

Questo flusso è ideale per le applicazioni in cui gli utenti interagiscono direttamente con l'applicazione per accedere ai dati di Google Analytics all'interno di un browser. Elimina la necessità di funzionalità lato server, ma rende impraticabile la generazione di report automatici, offline o pianificati.

Esempio:

Applicazioni installate

Questo flusso riguarda le applicazioni distribuite come pacchetto e installate dall'utente. Questo flusso richiede che l'applicazione o l'utente abbia accesso a un browser per completare il flusso di autenticazione.

Esempi:

  • Un widget desktop su PC o Mac.
  • Plug-in per un sistema di gestione dei contenuti: il vantaggio di questo flusso rispetto al server web o al lato client è che per la tua applicazione è possibile utilizzare un singolo progetto della console API. In questo modo è possibile consolidare i report e semplificare l'installazione per gli utenti.

Account di servizio

Gli account di servizio sono utili per l'accesso automatico, offline o programmato ai dati di Google Analytics per il tuo account. Ad esempio, per creare una dashboard dal vivo dei tuoi dati di Google Analytics e condividerla con altri utenti.

Per iniziare a utilizzare l'API Analytics, devi prima utilizzare lo strumento di configurazione, che ti guida attraverso la creazione di un progetto nella console API di Google, l'attivazione dell'API e la creazione delle credenziali.

Per configurare un nuovo account di servizio:

  1. Fai clic su Crea credenziali > Chiave account di servizio.
  2. Scegli se scaricare la chiave pubblica/privata dell'account di servizio come file P12 standard o come file JSON che può essere caricato da una libreria client API di Google.

Viene generata e scaricata sul tuo computer una nuova coppia di chiave pubblica/privata, che sarà l'unica copia esistente. Sei responsabile della sua sicurezza.

Risoluzione dei problemi

L'autorizzazione non viene completata correttamente nelle seguenti situazioni:

  • Riceverai un codice di stato 401 se il tuo access_token è scaduto o se utilizzi l'ambito sbagliato per l'API.

  • Riceverai un codice di stato 403 se l'utente autorizzato non ha accesso alla vista (profilo). Accertati di disporre dell'autorizzazione per l'utente corretto e che quest'ultimo disponga effettivamente della vista (profilo) che hai selezionato.

OAuth 2.0 Playground

Questo strumento consente di seguire l'intero flusso di autorizzazione attraverso un'interfaccia web. Lo strumento visualizza anche tutte le intestazioni delle richieste HTTP necessarie per effettuare una query autorizzata. Se non riesci a ottenere l'autorizzazione per funzionare nella tua applicazione, dovresti provare a farla funzionare in OAuth 2.0. A questo punto, puoi confrontare le intestazioni e le richieste HTTP provenienti da Playground con i dati che l'applicazione invia a Google Analytics. Questo controllo è un modo semplice per verificare di formattare correttamente le richieste.

Concessione non valida

Quando provi a utilizzare un token di aggiornamento, quanto segue restituisce un errore invalid_grant:

  • L'orologio del server non è sincronizzato con il Network Time Protocol - NTP.
  • Il limite di token di aggiornamento è stato superato.

Le applicazioni possono richiedere più token di aggiornamento per accedere a un singolo account Google Analytics.

Ad esempio, se un utente vuole installare un'applicazione su più computer e accedere allo stesso account Google Analytics, sarà necessario un token separato per ogni computer. Se il numero di token di aggiornamento supera il limite, i token meno recenti non sono più validi. Se l'applicazione tenta di utilizzare un token di aggiornamento invalidato, viene restituita una risposta di errore invalid_grant.

Il limite per ogni coppia univoca di client OAuth 2.0 e di account Google Analytics è di 25 token di aggiornamento. Se l'applicazione continua a richiedere token di aggiornamento per la stessa coppia client/account, una volta emesso il 26° token, il primo token di aggiornamento emesso in precedenza non sarà più valido. Il 27° token di aggiornamento richiesto invalida il secondo token emesso in precedenza e così via.