Configurare OAuth per l'app per Android

Le API Home utilizzano OAuth 2.0 per concedere l'accesso ai dispositivi della struttura. OAuth consente a un utente di concedere l'autorizzazione a un'app o a un servizio senza dover divulgare le proprie credenziali di accesso.

Se hai già un client OAuth verificato (ad esempio da un'app già pubblicata), puoi utilizzarlo per testare le API Home senza configurarne uno nuovo. Per ulteriori informazioni, consulta la sezione Se hai già un client OAuth.

Firmare l'app

Innanzitutto, genera una chiave OAuth eseguendo la tua app in Android Studio. Quando esegui o esegui il debug di un'app in Android Studio, viene generata automaticamente una chiave OAuth destinata allo sviluppo e al debug. Per una spiegazione completa, consulta Android Studio: firma la build di debug.

Una volta avviata l'app:

  1. Collega il dispositivo mobile al computer locale. Android Studio elenca i tuoi dispositivi connessi in base al numero di modello. Seleziona il tuo dispositivo dall'elenco, quindi fai clic su Esegui progetto. L'app di esempio viene compilata e installata sul tuo dispositivo mobile.

    Per istruzioni più dettagliate, consulta Eseguire app su un dispositivo hardware sul sito Android for Developers.

  2. Interrompi l'app in esecuzione.

  3. Ottieni la fingerprint SHA-1 del certificato OAuth seguendo le istruzioni dettagliate in Configurazione di OAuth 2.0 / App native/Android sul sito di assistenza della console Google Cloud.

  1. Nella console Google Cloud, vai alla dashboard del selettore di progetti e seleziona il progetto che vuoi utilizzare per creare le credenziali OAuth.
  2. Vai alla pagina API e servizi e fai clic su Credenziali nel menu di navigazione.

  3. Se non hai ancora configurato la schermata del consenso per questo progetto Google Cloud, viene visualizzato il pulsante Configura schermata del consenso. In questo caso, configura la schermata del consenso utilizzando la procedura riportata di seguito. In caso contrario, vai alla sezione successiva.

    1. Fai clic su Configura schermata di consenso. Viene visualizzata la pagina della schermata per il consenso OAuth.
    2. A seconda del caso d'uso, seleziona Interno o Esterno e fai clic su Crea. Viene visualizzato il riquadro Schermata per il consenso OAuth.
    3. Inserisci le informazioni nella pagina Informazioni sull'app seguendo le istruzioni sullo schermo e poi fai clic su Salva e continua. Viene visualizzato il riquadro Ampi dello spettro.
    4. Non devi aggiungere ambiti, quindi fai clic su Salva e continua. Viene visualizzato il riquadro Utenti di test.
    5. Se vuoi aggiungere utenti per testare l'accesso alla tua app, fai clic su Aggiungi utenti. Viene visualizzato il riquadro Aggiungi utenti. Gli utenti di test hanno il privilegio di concedere le autorizzazioni nella tua app.
    6. Nel campo vuoto, aggiungi uno o più indirizzi email dell'Account Google, poi fai clic su Aggiungi.
    7. Fai clic su Salva e continua. Viene visualizzato il riquadro Riepilogo.
    8. Rivedi le informazioni della schermata per il consenso OAuth, quindi fai clic su Torna alla dashboard.

Per informazioni dettagliate, consulta la sezione Configurare la schermata per il consenso OAuth sul sito di assistenza della console Google Cloud.

Registra l'app e crea le credenziali

Per registrare l'app per OAuth 2.0 e creare le credenziali OAuth, segui le istruzioni fornite in Configurare OAuth 2.0. Dovrai indicare il tipo di app, ovvero app nativa/Android.

Aggiungi l'impronta SHA-1 ottenuta dalla firma dell'app al client OAuth configurato nella console Google Cloud seguendo le istruzioni riportate in Configurazione di OAuth 2.0 / app native sul sito di assistenza della console Google Cloud.

Con il dispositivo mobile connesso alla macchina locale, selezionalo dall'elenco, quindi fai di nuovo clic su Esegui progetto per eseguirlo. Per istruzioni più dettagliate, consulta Eseguire app su un dispositivo hardware sul sito Android for Developers.

Se hai già un client OAuth

Se hai già un client OAuth verificato per un'app pubblicata, puoi utilizzare il client OAuth esistente per testare le API Home.

La registrazione a Google Home Developer Console non è necessaria per testare e utilizzare le API Home. Tuttavia, per pubblicare l'app dovrai comunque disporre di una registrazioneDeveloper Console approvata, anche se hai un client OAuth verificato di un'altra integrazione.

Si applicano le seguenti considerazioni:

  • Esiste un limite di 100 utenti quando si utilizza un client OAuth esistente. Per informazioni sull'aggiunta di utenti di test, consulta Configurare la schermata di consenso OAuth. Indipendentemente dalla verifica OAuth, esiste un limite imposto dalle API Home di 100 utenti che possono concedere autorizzazioni alla tua applicazione. Questa limitazione viene rimossa al termine della registrazione a Developer Console.

  • LaDeveloper Console deve essere inviata per l'approvazione quando è tutto pronto per limitare le concessioni per tipo di dispositivo tramite OAuth in vista dell'aggiornamento dell'app con le API Home.

Per le app Google Cloud per le quali la verifica OAuth è ancora in attesa, gli utenti non possono completare il flusso OAuth finché la verifica non è completata. I tentativi di concessione delle autorizzazioni non andranno a buon fine a causa del seguente errore:

Access blocked: <Project Name> has not completed the Google verification process.