Panoramica

借助基于 OAuth 的应用快速关联(应用快速关联),您的用户可以轻松地将其在身份验证系统中的帐号关联到其 Google 帐号。如果您的应用在用户启动帐号关联流程时安装在用户手机上,则可以无缝同步到您的应用以获取用户授权。

此方法可让用户更快、更轻松地完成关联流程,因为用户无需重新输入用户名和密码进行身份验证;而应用快速关联可利用您应用中的用户帐号的凭据。用户将其 Google 帐号与您的应用关联后,他们即可利用您开发的任何集成。

您可以为 iOS 和 Android 应用设置应用快速关联。

此图显示了用户将其 Google 帐号与身份验证系统关联的步骤。第一张屏幕截图显示了在用户的 Google 帐号与您的应用相关联的情况下,用户如何选择您的应用。第二张屏幕截图显示了将 Google 帐号与应用相关联的确认信息。第三张屏幕截图显示了 Google 应用中已成功关联的用户帐号。
图 1.使用应用快速关联功能在用户的手机上关联帐号。

要求

如需实现应用快速关联,您必须满足以下要求:

  • 您必须拥有 Android 或 iOS 应用。
  • 您必须拥有、管理和维护支持 OAuth 2.0 授权代码流的 OAuth 2.0 服务器。

Per maggiori informazioni sul flusso del codice di autorizzazione per il collegamento a OAuth, consulta Implementare il server OAuth.

Istruzioni sul design

Questa sezione descrive i requisiti e i consigli di progettazione per la schermata per il consenso per il collegamento dell'account Flip App. Dopo aver chiamato l'app, Google mostra la schermata di consenso all'utente.

Requisiti

  1. Devi comunicare che l'account dell'utente è collegato a Google, non a un prodotto Google specifico, come Google Home o Assistente Google.

Suggerimenti

Ti consigliamo di procedere come segue:

  1. Visualizza le Norme sulla privacy di Google. Includi un link alle Norme sulla privacy di Google nella schermata di consenso.

  2. Dati da condividere. Utilizza un linguaggio chiaro e conciso per spiegare all'utente quali dati sono richiesti da Google e perché.

  3. Invito all'azione chiaro. Specifica un chiaro invito all'azione nella schermata di consenso, ad esempio "Accetta e collega". Il motivo è che gli utenti devono capire quali dati devono condividere con Google per collegare i loro account.

  4. Possibilità di annullare. Specifica un modo per gli utenti di tornare indietro o annullare, se scelgono di non collegare.

  5. Possibilità di scollegamento. Offrire agli utenti un meccanismo per scollegarli, ad esempio un URL alle impostazioni del loro account sulla tua piattaforma. In alternativa, puoi includere un link all'Account Google in cui gli utenti possono gestire il proprio account collegato.

  6. Possibilità di cambiare l'account utente. Suggerisci un metodo che consenta agli utenti di 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 a Google un errore irreversibile per poter accedere all'account desiderato con il collegamento OAuth e il flusso implicito.
  7. Includi il tuo logo. Mostrare il logo dell'azienda nella schermata per il consenso. Segui le linee guida relative allo stile per posizionare il logo. Se vuoi mostrare anche il logo di Google, consulta la sezione Loghi e marchi.

Questa figura mostra una schermata di consenso di esempio con callout ai singoli requisiti e consigli da seguire quando progetti una schermata di consenso dell'utente.
Figura 2. Linee guida per la progettazione della schermata per il consenso per il collegamento dell'account.

Configura per App Flip basata su OAuth

Le seguenti sezioni descrivono i prerequisiti per l'App Flip basata su OAuth e come configurare il tuo progetto App Flip nella console Actions.

Crea un'azione e configura un server OAuth 2.0

Prima di poter configurare App Flip, devi eseguire le seguenti operazioni:

Configura App Flip nella console di Actions

La seguente sezione descrive come configurare App Flip nella console di Actions.

  1. Fai clic su Develop (Sviluppa) nella navigazione in alto. Poi, fai clic su Collegamento dell'account nel menu di navigazione a sinistra.
  2. Attiva l'opzione accanto a Collegamento dell'account.
  3. In Creazione account, seleziona No, voglio solo consentire la creazione di account sul mio sito web.
  4. Fai clic su Avanti.
  5. In Tipo di collegamento, seleziona OAuth e Codice di autorizzazione dai menu a discesa.
  6. Fai clic su Avanti.
  7. Compila tutti i campi in Informazioni sul client OAuth. Se l'opzione App Flip non è supportata, viene utilizzato OAuth standard come metodo di riserva.
  8. Fai clic su Avanti.
  9. In (Facoltativo) Usa l'app per il collegamento dell'account, seleziona Attiva per iOS.
  10. Compila il campo Link universale. Per ulteriori informazioni sui link universali, consulta la sezione Consentire ad app e siti web di collegarsi ai propri contenuti .
  11. Se vuoi configurare il client, aggiungi gli ambiti e fai clic su Aggiungi ambito in Configura il client (facoltativo). In caso contrario, fai clic su Avanti.
  12. In Istruzioni per il test, digita test (o qualsiasi altra stringa) come segnaposto. (La compilazione di questo campo con un account di prova è necessaria solo se stai effettivamente inviando l'Azione da pubblicare).
  13. Fai clic su Salva.

Ora puoi passare alla sezione successiva per implementare App Flip nella tua app per iOS o Android.

Implementare App Flip nelle app native

Per implementare App Flip, devi modificare il codice di autorizzazione dell'utente nella tua app per accettare un link diretto da Google.

Testa App Flip sul tuo dispositivo

Dopo aver creato un'azione e configurato App Flip nella console e nell'app, puoi testare App Flip sul tuo dispositivo mobile. Puoi usare l'app Assistente Google per testare App Flip.

Per testare l'opzione Capovolgi app dall'app dell'assistente, svolgi i seguenti passaggi:

  1. Vai alla console di Actions e seleziona il tuo progetto.
  2. Fai clic su Test nella barra di navigazione in alto.
  3. Attiva il flusso di collegamento dell'account dall'app Assistente:
    1. Apri l'app Assistente Google.
    2. Fai clic su Impostazioni.
    3. Nella scheda Assistente, fai clic su Controllo della casa.
    4. Fai clic su Aggiungi(+).
    5. Seleziona l'Azione dall'elenco dei provider. Sarà preceduto da "[test]" nell'elenco. Quando selezioni l'azione [test] dall'elenco, dovrebbe aprire la tua app.
    6. Verifica che la tua app sia stata avviata e inizia a testare il flusso di autorizzazione.