Virar aplicativo

Depois de implementar o OAuth 2.0, você terá a opção de configurar App Flip com base em Auth, permitindo que os usuários vinculem mais rapidamente as contas no seu sistema de autenticação às Contas do Google. As seções a seguir descrevem como projetar e implementar App Flip para a ação smart home.

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 do App Flip baseado em OAuth e como configurar seu projeto App Flip no Console do Actions.

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

Antes de configurar o App Flip, faça o seguinte:

Configurar App Flip no Console do Actions

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

  1. Preencha todos os campos em Informações do cliente OAuth. Se não houver suporte a App Flip, o OAuth normal será usado como substituto.
  2. Em Use 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 Como permitir que apps e sites sejam vinculados ao seu conteúdo.
  4. Se você quiser configurar seu cliente, adicione escopos e clique em Adicionar escopo em Configurar seu cliente (opcional).
  5. Clique em Salvar.

Agora, prossiga para a próxima seção para implementar App Flip no seu app iOS ou Android.

Implementar App Flip nos seus apps 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.

Teste o App Flip no seu dispositivo

Agora que você criou uma ação e configurou o App Flip no console e no app, teste o App Flip no seu dispositivo móvel. Você pode usar Google Assistant app ou Google Home app (GHA) para testar App Flip.

Para testar o App Flip no Google Assistant app, 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 da conta no app Google Assistant:
    1. Abra o Google Assistant app.
    2. Clique em Configurações.
    3. Na guia Assistant, clique em Automação residencial.
    4. Clique em Adicionar(+).
    5. Selecione a ação na lista de provedores. O prefixo "[test]" vai ser prefixado na lista. Depois que você selecionar a ação [test] na lista, o app será aberto.
    6. Verifique se o app foi iniciado e comece a testar o fluxo de autorização.

Para testar o App Flip no app Google Home, 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 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 a ação smart home na lista de provedores. O prefixo "[test]" vai ser prefixado na lista. Depois que você selecionar a ação [test] na lista, o app será aberto.
    6. Verifique se o app foi iniciado e comece a testar o fluxo de autorização.