Le API Home utilizzano OAuth 2.0 per concedere l'accesso ai dispositivi nella struttura. OAuth consente a un utente di concedere l'autorizzazione a un'app o a un servizio senza dover esporre 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 doverne configurare uno nuovo. Per saperne di più, vedi Se hai un client OAuth esistente.
Firmare l'app
Innanzitutto, genera un certificato di debug eseguendo l'app in Android Studio. Quando esegui o esegui il debug di un'app in Android Studio, viene generato automaticamente un certificato di debug destinato allo sviluppo e al debug. Per una spiegazione completa, vedi Android Studio: firma la build di debug .
Una volta che l'app è in esecuzione:
Collega il dispositivo mobile alla macchina locale. Android Studio elencherà i dispositivi collegati in base al numero di modello. Seleziona il dispositivo dall'elenco, quindi fai clic su Esegui progetto. In questo modo, la sample app viene creata e installata sul dispositivo mobile.
Per istruzioni più dettagliate, vedi Eseguire app su un dispositivo hardware sul sito per sviluppatori Android.
Arresta l'app in esecuzione.
Recupera la fingerprint SHA-1 del certificato di debug seguendo le istruzioni dettagliate in Configurare OAuth 2.0 / Applicazioni native/ Android sul sito di assistenza della console Google Cloud.
Configurare la schermata per il consenso OAuth
- Nella console Google Cloud, vai alla dashboard del selettore di progetti e seleziona il progetto che vuoi utilizzare per creare le credenziali OAuth.
- Vai alla pagina API e servizi e fai clic su Credenziali nel menu di navigazione.
Se non hai ancora configurato la schermata per il consenso per questo progetto Google Cloud, viene visualizzato il pulsante Configura schermata per il consenso. In questo caso, configura la schermata per il consenso utilizzando la seguente procedura. In caso contrario, vai alla sezione successiva.
- Fai clic su Configura schermata per il consenso. Viene visualizzata la pagina Schermata per il consenso OAuth.
- A seconda del tuo caso d'uso, seleziona Interno o Esterno, quindi fai clic su Crea. Viene visualizzato il riquadro Schermata per il consenso OAuth.
- Inserisci le informazioni nella pagina Informazioni sull'app seguendo le istruzioni sullo schermo, quindi fai clic su Salva e continua. Viene visualizzato il riquadro Ambiti.
- Non devi aggiungere ambiti, quindi fai clic su Salva e continua. Viene visualizzato il riquadro Utenti di test.
- Fai clic su Pubblico e poi sul pulsante + AGGIUNGI UTENTI.
- Inserisci l'indirizzo email dell'utente di test e fai clic sul pulsante SALVA.
- Fai clic su Salva e continua. Viene visualizzato il riquadro Riepilogo.
- Esamina le informazioni della schermata per il consenso OAuth, quindi fai clic su Torna alla dashboard.
Per informazioni dettagliate, vedi Configurare la schermata per il consenso OAuth sul sito di assistenza della console Google Cloud.
Registrare l'app e creare le credenziali
Per registrare l'app per OAuth 2.0 e creare le credenziali OAuth, segui le istruzioni riportate in Configurare OAuth 2.0. Dovrai indicare il tipo di app, ovvero app nativa/app per Android.
Aggiungi la fingerprint SHA-1 ottenuta da firma dell'app al client OAuth che hai configurato nella console Google Cloud seguendo le istruzioni riportate in Configurare OAuth 2.0 / Applicazioni native sul sito di assistenza della console Google Cloud.
Con il dispositivo mobile collegato alla macchina locale, seleziona il dispositivo dall'elenco, quindi fai di nuovo clic su Esegui progetto per eseguirlo. Per istruzioni più dettagliate, vedi Eseguire app su un dispositivo hardware sul sito per sviluppatori Android.
Se hai un client OAuth esistente
Se hai già un client OAuth verificato per un'app pubblicata, puoi utilizzarlo per testare le API Home.
La registrazione Google Home Developer Console non è obbligatoria per testare e utilizzare le API Home. Tuttavia, dovrai comunque avere una registrazione approvata Developer Console per pubblicare l'app, anche se hai un client OAuth verificato da un'altra integrazione.
Si applicano le seguenti considerazioni:
Quando utilizzi un client OAuth esistente, esiste un limite di 100 utenti. Per informazioni sull'aggiunta di utenti di test, consulta Configura la schermata per il consenso OAuth. Indipendentemente dalla verifica OAuth, le API Home impongono un limite di 100 utenti che possono concedere autorizzazioni alla tua applicazione. Questa limitazione viene rimossa al termine della registrazione Developer Console.
Developer Console registrazione deve essere inviata per l'approvazione quando sei pronto a limitare le concessioni di tipo di dispositivo tramite OAuth in preparazione all'aggiornamento dell'app con le API Home.
Per le app Google Cloud per cui la verifica OAuth è ancora in attesa, gli utenti non possono completare il flusso OAuth finché la verifica non è stata completata. I tentativi di concessione delle autorizzazioni non andranno a buon fine e verrà visualizzato il seguente errore:
Access blocked: <Project Name> has not completed the Google verification process.