Una volta implementato OAuth 2.0, puoi configurare facoltativamente App Flip basato su OAuth, che consente agli utenti di App Flip di collegare più rapidamente i propri account nel tuo sistema di autenticazione ai loro Account Google.Android Le sezioni seguenti descriveranno come progettare e implementare App Flip per l'integrazione di Cloud-to-cloud.
Istruzioni sul design
Questa sezione descrive i requisiti di progettazione e i consigli per la schermata per il consenso per il collegamento dell'account AppFlip. Dopo che Google chiama la tua app, quest'ultima mostra all'utente la schermata per il consenso.
Requisiti
- Devi avere una dichiarazione di autorizzazione di Google come "Una volta eseguito il collegamento, Google avrà l'autorizzazione per controllare i tuoi dispositivi".
- Devi comunicare che l'account dell'utente è stato collegato a Google, non a un prodotto Google specifico, come Google Home o l'Assistente Google.
- Devi indicare un invito all'azione chiaro nella schermata di consenso e utilizzare la dicitura "Accetta e collega" per l'azione di collegamento. Questo perché gli utenti devono capire quali dati sono tenuti a condividere con Google per collegare i loro account.
- Devi fornire agli utenti un modo per tornare indietro o annullare il collegamento, se scelgono di non effettuare il collegamento. Usa la dicitura "Annulla" per l'azione di annullamento.
- Devi implementare questo flusso di lavoro: dopo aver fatto clic su "Accetta e collega", devi mostrare il collegamento riuscito e reindirizzare automaticamente l'utente all'app Google Home. Ora l'utente dovrebbe vedere il dispositivo collegato nell'app Google Home con la tua azione. Dopo aver fatto clic su "Annulla", dovresti reindirizzare l'utente all'app Google Home.
Suggerimenti
Ti consigliamo di procedere nel seguente modo:
Visualizza le Norme sulla privacy di Google. Includi un link alle Norme sulla privacy di Google nella schermata per il consenso.
Dati da condividere. Utilizza un linguaggio chiaro e conciso per comunicare all'utente quali dati richiede Google e perché.
Possibilità di scollegamento. Offri agli utenti un meccanismo di scollegamento, ad esempio un URL che rimanda alle impostazioni dell'account sulla tua piattaforma. In alternativa, puoi includere un link all'Account Google in cui gli utenti possono gestire il proprio account collegato.
Possibilità di cambiare account utente. Suggerisci agli utenti un metodo per cambiare account. Ciò è particolarmente utile se gli utenti tendono ad avere più account.
- Se un utente deve chiudere la schermata di consenso per cambiare account, invia un errore recuperabile a Google in modo che l'utente possa accedere all'account desiderato con il collegamento OAuth e il flusso implicit.
Includi il tuo logo. Mostra il logo della tua azienda nella schermata per il consenso. Segui le tue linee guida per lo stile per posizionare il logo. Se vuoi mostrare anche il logo di Google, consulta la sezione Loghi e marchi.
Configurazione per App Flip basato su OAuth
Le sezioni seguenti descrivono i prerequisiti per App Flip basato su OAuth e come configurare il progetto App Flip nella Console per sviluppatori Google Home.
Crea un'integrazione cloud-to-cloud e configura un server OAuth 2.0
Prima di poter configurare App Flip, devi:
- Configura un server OAuth 2.0. Per ulteriori informazioni sulla configurazione di un server OAuth, consulta l'articolo Implementare un server OAuth 2.0.
- Crea un'integrazione cloud-to-cloud. Per creare un'integrazione, segui le istruzioni riportate in Creare un'integrazione cloud-to-cloud.
Configurare la rotazione dell'app nella Console per gli sviluppatori
La sezione seguente descrive come configurare la funzionalità App Flip nella Console per gli sviluppatori.
- Compila tutti i campi in Informazioni sul client OAuth. Se App Flip non è supportato, viene utilizzato OAuth normale come opzione di riserva.
- In Utilizza la tua app per il collegamento degli account(facoltativo), seleziona Attiva per iOS.
- Compila il campo Link universale. Per ulteriori informazioni sui link universali, consulta Consentire ad app e siti web di creare link ai tuoi contenuti.
- Se vuoi configurare facoltativamente il client, aggiungi gli ambiti e fai clic su Aggiungi ambito in Configura il client (facoltativo).
- Fai clic su Salva.
Ora puoi passare alla sezione successiva per implementare App Flip nell'app Android per iOS.
Implementare App Flip nelle app native
Per implementare App Flip, devi modificare il codice di autorizzazione utente nella tua app in modo che accetti un link diretto da Google.
Testare App Flip sul dispositivo
Ora che hai creato un'integrazione cloud-to-cloud e hai configurato App Flip nella console e nella tua app, puoi testare App Flip sul tuo dispositivo mobile. Puoi utilizzare l'app Google Home per testare la funzionalità App Flip.
Per testare App Flip dall'app Google Home:
- Vai a Developer Console e seleziona il tuo progetto.
- Vai a Tra cloud > Test.
- Attiva il flusso di collegamento dell'account dall'app Home:
- Apri Google Home app (GHA).
- Fai clic sul pulsante +.
- Fai clic su Configura dispositivo.
- Fai clic su Hai già configurato qualcosa?
- Seleziona l'integrazione cloud-to-cloud dall'elenco dei fornitori. Verrà anteposto il prefisso "[test]" nell'elenco. Quando selezioni l'integrazione [test] dall'elenco, dovrebbe aprirsi l'app.
- Verifica che l'app sia stata lanciata e inizia a testare il flusso di autorizzazione.