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 Android vinculem 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 com base em OAuth
As seções a seguir descrevem os pré-requisitos para o App Flip baseado em OAuth e como configurar seu projeto do App Flip no Google Home Developer Console.
Criar uma integração entre nuvens e configurar um servidor OAuth 2.0
Antes de configurar o App Flip, faça o seguinte:
- Configurar 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 entre nuvens. Para criar uma integração, siga as instruções em Criar uma integração entre nuvens.
Configurar a alternância de apps no Play Console
A seção a seguir descreve como configurar a alternância de apps no console do desenvolvedor.
- Preencha todos os campos em Informações do cliente OAuth. Se o App Flip não tiver suporte, o OAuth normal será usado como substituto.
- Em Usar seu app para vincular contas(opcional), marque Ativar para iOS.
- Preencha o campo Link universal. Para mais informações sobre links universais, consulte Como permitir que apps e sites criem links para seu conteúdo.
- Se quiser configurar seu cliente, adicione escopos e clique em Adicionar escopo em Configurar seu cliente (opcional).
- Clique em Salvar.
Agora você pode continuar para a próxima seção e implementar App Flip no seu app para iOS ou Android.
Implementar App Flip nos seus apps nativos
Para implementar App Flip, você precisa modificar o código de autorização do usuário no app para aceitar um link direto do Google.
Teste App Flip no seu dispositivo
Agora que você criou uma integração entre nuvens e configurou o App Flip no console e no app, é possível testar o recurso no seu dispositivo móvel. Você pode usar o app Google Home para testar o recurso "Flip the App".
Para testar App Flip no app Google Home, siga estas etapas:
- Acesse o console do desenvolvedor e selecione seu projeto.
- Acesse Entre nuvens > Teste.
- 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 a integração entre nuvens na lista de provedores. Ele vai ter o prefixo "[test]" na lista. Quando você selecionar a integração [teste] na lista, o app será aberto.
- Verifique se o app foi iniciado e comece a testar o fluxo de autorização.