Visão geral

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

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

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

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

要求

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

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

Para mais informações sobre o fluxo do código de autorização de vinculação do OAuth, consulte Implementar seu servidor OAuth.

Diretrizes de design

Nesta seção, descrevemos os requisitos de design e as recomendações para a tela de consentimento da vinculação da conta do AppFlip. Depois que o Google chamar o app, ele exibirá a tela de consentimento ao usuário.

Requisitos

  1. Você precisa comunicar que a conta do usuário está sendo vinculada ao Google, e não a um produto específico, como o Google Home ou Google Assistente.

Recomendações

Portanto, recomendamos que você faça o seguinte:

  1. Exibir a Política de Privacidade do Google. Inclua um link para a Política de Privacidade do Google na tela de consentimento.

  2. Dados a serem compartilhados. Use uma linguagem clara e concisa para dizer ao usuário quais dados o Google exige e por quê.

  3. Call-to-action clara. Insira uma call-to-action clara na tela de consentimento, como "Aceitar e vincular". Isso ocorre porque os usuários precisam entender quais dados eles precisam compartilhar com o Google para vincular as contas.

  4. Opção de cancelamento. Ofereça aos usuários a opção de voltar ou cancelar.

  5. Capacidade de desvincular. Ofereça um mecanismo para os usuários desvincularem, como um URL para as configurações da conta na plataforma. Se preferir, inclua um link para a Conta do Google em que os usuários possam gerenciar a conta vinculada.

  6. É possível mudar a conta de usuário. Sugerir um método para os usuários trocarem de conta. Isso é útil principalmente quando os usuários costumam ter várias contas.

    • Se um usuário precisar fechar a tela de consentimento para alternar entre contas, envie um erro recuperável ao Google para que o usuário possa fazer login na conta desejada com vinculação do OAuth e o fluxo implícito.
  7. Inclua seu logotipo. Exiba o logotipo da sua empresa na tela de consentimento. Use suas diretrizes de estilo para inserir o logotipo. Se você também quiser exibir o logotipo do Google, consulte Logotipos e marcas registradas.

A figura mostra um exemplo de tela de consentimento com chamadas para os requisitos individuais e recomendações que serão seguidas quando você criar uma tela de consentimento do usuário.
Figura 2. Diretrizes de design da tela de consentimento para vinculação de contas.

Configurar a conversão de apps com base em OAuth

As seções a seguir descrevem os pré-requisitos do App Flip com base em OAuth e como configurar seu projeto do App Flip no Console do Actions.

Criar uma ação e configurar um servidor OAuth 2.0

Antes de configurar a virada de app, faça o seguinte:

Configurar o App Flip no Console do Actions

A seção a seguir descreve como configurar o App Flip no Console do Actions.

  1. Clique em Desenvolver na navegação superior. Depois, clique em Vinculação de contas no painel de navegação à esquerda.
  2. Alterne a chave ao lado de Vinculação de contas.
  3. Em Criação de conta, selecione Não, quero permitir apenas a criação de contas no meu site.
  4. Clique em Next.
  5. Em Tipo de vinculação, selecione OAuth e Código de autorização nos menus suspensos.
  6. Clique em Next.
  7. Preencha todos os campos de Informações do cliente OAuth. Se o App Flip não tiver suporte, o OAuth normal será usado como substituto.
  8. Clique em Next.
  9. Em Use seu app para vinculação de contas (opcional), marque Ativar para iOS.
  10. Preencha o campo Link universal. Para mais informações sobre links universais, consulte Como permitir que apps e sites sejam vinculados ao seu conteúdo .
  11. Se você quiser configurar seu cliente, adicione escopos e clique em Adicionar escopo em Configurar seu cliente (opcional). Caso contrário, clique em Próxima.
  12. Em Instruções de teste, digite test (ou qualquer outra string) como marcador de posição. O preenchimento desse campo com uma conta de teste só é necessário se você estiver realmente enviando a Ação para ser publicada.
  13. Clique em Salvar.

Na próxima seção, você pode implementar o App Flip no seu app para iOS ou Android.

Implementar a App Flip nos seus aplicativos nativos

Para implementar o App Flip, é necessário modificar o código de autorização do usuário no seu app para aceitar um link direto do Google.

Testar o App Flip no seu dispositivo

Agora que você criou uma ação e configurou o App Flip no console e no seu app, pode testar o App Flip no seu dispositivo móvel. Você pode usar o app Google Assistente para testar o App Flip.

Para testar o App Flip no app Google Assistente, siga estas etapas:

  1. Acesse o Console do Actions e selecione seu projeto.
  2. Clique em Testar na navegação da parte de cima.
  3. Acione o fluxo de vinculação de contas no app Google Assistente:
    1. Abra o app Google Assistente.
    2. Clique em Configurações.
    3. Na guia "Assistente", clique em Automação residencial.
    4. Clique em Adicionar(+).
    5. Selecione sua ação na lista de provedores. Ele será prefixado com "[test]" na lista. Quando você selecionar a ação [test] na lista, o app será aberto.
    6. Verifique se o aplicativo foi iniciado e comece a testar o fluxo de autorização.