Depois de ter uma implementação do OAuth 2.0, você pode configurar App Flip com base no OAuth, o que permite que os usuários do Android vinculem mais rapidamente as contas no sistema de autenticação às Contas do Google. As seções a seguir descrevem como projetar e implementar App Flip para sua integração Cloud-to-cloud.
Diretrizes de design
Nesta seção, descrevemos os requisitos e as recomendações de design para a tela de consentimento para vinculação de contas do App Flip. Depois que o Google chama seu app, ele exibe a tela de consentimento ao usuário.
Requisitos
- Você precisa ter uma declaração de autorização do Google, como "Depois da vinculação, o Google terá permissão para controlar seus dispositivos".
- Informe que a conta do usuário está sendo vinculada ao Google, e não a um produto específico do Google, como o Google Home ou o Google Assistente.
- Você precisa declarar uma call-to-action clara na tela de consentimento e usar "Concordar e vincular" para a ação de vinculação. Isso ocorre porque os usuários precisam entender quais dados precisam compartilhar com o Google para vincular as contas.
- Ofereça uma maneira de os usuários retornarem ou cancelarem a assinatura, caso decidam não vincular. Use a frase "Cancelar" para a ação de cancelamento.
- É necessário implementar este fluxo de trabalho: depois de clicar em "Concordar e vincular", mostre a vinculação e redirecione o usuário de volta para o app Google Home automaticamente. Agora o usuário verá o dispositivo vinculado no app Google Home com sua ação. Depois de clicar em "Cancelar", redirecione o usuário de volta para o app Google Home.
Recomendações
Portanto, recomendamos que você faça o seguinte:
Mostrar a Política de Privacidade do Google. Inclua um link para a Política de Privacidade do Google na tela de consentimento.
Dados a serem compartilhados. Use uma linguagem clara e concisa para informar ao usuário quais dados do Google o Google exige e por quê.
Possibilidade de desvinculação. Ofereça um mecanismo para os usuários se desvincularem, como um URL para as configurações da conta deles na sua plataforma. Outra opção é incluir um link para a Conta do Google, em que os usuários podem gerenciar a conta vinculada.
Possibilidade de mudar a conta de usuário. Sugira um método para os usuários trocarem de conta. Isso é especialmente benéfico se os usuários tendem a 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 ele possa fazer login na conta desejada com a vinculação do OAuth e o fluxo implícito.
Inclua seu logotipo. Exibir o logotipo da sua empresa na tela de permissão. Use suas diretrizes de estilo para posicionar o logotipo. Se você também quiser exibir o logotipo do Google, consulte Logotipos e marcas registradas.
Configurar para App Flip baseado em OAuth
As seções a seguir descrevem os pré-requisitos para a troca de apps baseada em OAuth e como configurar seu projeto de troca de apps no Google Home Developer Console.
Criar uma integração de nuvem para nuvem e configurar um servidor OAuth 2.0
Antes de configurar o App Flip, faça o seguinte:
- Configure um servidor OAuth 2.0. Para mais informações sobre como configurar um servidor OAuth, consulte Implementar um servidor OAuth 2.0.
- Crie uma integração de nuvem para nuvem. Para criar uma integração, siga as instruções em Criar uma integração de nuvem para nuvem.
Configurar a troca de apps no Play Console
A seção a seguir descreve como configurar a troca de apps no Developer Console.
- Preencha todos os campos em Informações do cliente OAuth. Se App Flip não for compatível, o OAuth normal será usado como substituto.
- Em Usar seu app para vinculação de contas(opcional), marque Ativar para iOS.
- Preencha o campo Link universal. Para mais informações sobre links universais, consulte Permitir que apps e sites criem links para seu conteúdo.
- Se quiser configurar o cliente, adicione escopos e clique em Adicionar escopo em Configurar o cliente (opcional).
- Clique em Salvar.
Agora você pode continuar para a próxima seção e implementar o App Flip no seu app iOS ou Android.
Implementar o App Flip nos seus apps nativos
Para implementar o App Flip, modifique o código de autorização do usuário no app para aceitar um link direto do Google.
Testar App Flip no seu dispositivo
Agora que você criou uma integração de nuvem para nuvem e configurou a troca de apps no console e no seu app, é possível testar a troca de apps no dispositivo móvel. Você pode usar o app Google Home para testar a troca de apps.
Para testar App Flip no app Google Home, siga estas etapas:
- Acesse o Developer Console e selecione seu projeto.
- Acesse Cloud-to-cloud > Testar.
- Acione o fluxo de vinculação da conta no app Home:
- Abra o Google Home app (GHA).
- Clique no botão +.
- Clique em Configurar dispositivo.
- Clique em Já tem algo configurado?
- Selecione sua integração de nuvem para nuvem na lista de provedores. Ele vai aparecer com o prefixo "[test]" na lista. Quando você selecionar a integração [de teste] na lista, o app vai abrir.
- Verifique se o app foi iniciado e comece a testar o fluxo de autorização.