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 per la casa senza configurarne uno nuovo. Per ulteriori informazioni, consulta Se disponi di un client OAuth esistente.
Firma l'app
Per prima cosa, genera un certificato di debug eseguendo la tua 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, consulta Android Studio: Sign your debug build.
Una volta che l'app è in esecuzione:
Collega il dispositivo mobile alla macchina locale. Android Studio elencherà i tuoi dispositivi connessi in base al numero di modello. Seleziona il tuo dispositivo dall'elenco, quindi fai clic su Esegui progetto. In questo modo viene creata e installata l'app di esempio sul tuo dispositivo mobile.
Per istruzioni più dettagliate, consulta Eseguire app su un dispositivo hardware sul sito Android for Developers.
Interrompi l'app in esecuzione.
Ottieni l'impronta digitale SHA-1 del certificato di debug seguendo le istruzioni dettagliate in Configurazione di OAuth 2.0 / Applicazioni native / Android sul sito della Guida di Google Cloud Console.
Configura 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. Altrimenti, passare alla sezione successiva.
- Fai clic su Configura schermata di consenso. Viene visualizzata la pagina Schermata per il consenso OAuth.
- A seconda del 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 delle 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.
- Rivedi le informazioni della schermata per il consenso OAuth, quindi fai clic su Torna alla dashboard.
Per maggiori dettagli, consulta Configurazione della schermata di consenso OAuth sul sito della Guida di Google Cloud Console.
Registrare l'app e creare le credenziali
Per registrare l'app per OAuth 2.0 e creare le credenziali OAuth, segui le istruzioni fornite nella pagina 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 / applicazioni native sul sito di assistenza della console Google Cloud.
Con il dispositivo mobile connesso 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 Android Developers.
Se hai un client OAuth esistente
Se disponi già di un client OAuth verificato per un'app pubblicata, puoi utilizzare il tuo client OAuth esistente per testare le API Home.
La registrazione Google Home Developer Console non è necessaria per testare e utilizzare le API Home. Tuttavia, avrai comunque bisogno di una registrazione Developer Console approvata per pubblicare la tua app, anche se disponi di un client OAuth verificato da un'altra integrazione.
Valgono le seguenti considerazioni:
Quando si utilizza un client OAuth esistente, il limite è di 100 utenti. Per informazioni sull'aggiunta di utenti di prova, fare riferimento aImposta 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.
La registrazioneDeveloper Console deve essere inviata per l'approvazione quando sei pronto a limitare le concessioni di tipo di dispositivo tramite OAuth in preparazione dell'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 è completata. I tentativi di concedere autorizzazioni falliranno e verrà visualizzato il seguente errore:
Access blocked: <Project Name> has not completed the Google verification process.