Virar aplicativo

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

  1. 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".
  2. 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.
  3. 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.
  4. 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.
  5. É 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:

  1. Mostrar 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 informar ao usuário quais dados do Google o Google exige e por quê.

  3. 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.

  4. 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.
  5. 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.

A figura mostra um exemplo de tela de consentimento com frases de destaque para os requisitos individuais e recomendações a serem seguidas ao criar uma tela de consentimento do usuário.
Figura 1: diretrizes de design para a tela de consentimento para vinculação de contas.

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:

Configurar a troca de apps no Play Console

A seção a seguir descreve como configurar a troca de apps no Developer Console.

  1. 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.
  2. Em Usar seu app para vinculação de contas(opcional), marque Ativar para iOS.
  3. Preencha o campo Link universal. Para mais informações sobre links universais, consulte Permitir que apps e sites criem links para seu conteúdo.
  4. Se quiser configurar o cliente, adicione escopos e clique em Adicionar escopo em Configurar o cliente (opcional).
  5. 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:

  1. Acesse o Developer Console e selecione seu projeto.
  2. Acesse Cloud-to-cloud > Testar.
  3. Acione o fluxo de vinculação da conta no app Home:
    1. Abra o Google Home app (GHA).
    2. Clique no botão +.
    3. Clique em Configurar dispositivo.
    4. Clique em Já tem algo configurado?
    5. 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.
    6. Verifique se o app foi iniciado e comece a testar o fluxo de autorização.