Depois de implementar o OAuth 2.0, você poderá configurar App Flip com base em autenticação, que permite que os usuários realizem ações mais rapidamente. vincular as contas deles em seu sistema de autenticação às Contas do Google deles. O as seções a seguir descrevem como projetar e implementar App Flip para sua 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
- 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 App Flip com base em OAuth e como configurar sua App Flip projeto 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:
- Configure um servidor OAuth 2.0. Para mais informações sobre como configurar uma conta servidor, consulte Implementar um servidor OAuth 2.0.
- Criar uma ação. Para criar uma ação, siga as instruções em Criar um projeto do Actions
Configurar App Flip no Console do Actions
A seção a seguir descreve como configurar o App Flip na Console do Actions.
- 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 Como permitir que apps e sites sejam vinculados ao seu conteúdo.
- Se você quiser configurar seu cliente, adicione escopos e clique em Adicionar escopo em Configurar seu cliente (opcional).
- Clique em Salvar.
Agora você pode prosseguir para a próxima seção para implementar App Flip no seu iOS ou App Android.
Implementar App Flip nos apps nativos
Para implementar o App Flip, você precisa modificar o código de autorização do usuário na sua 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 seu app, teste App Flip no seu dispositivo móvel. Você pode usar o Google Assistant app ou Google Home app (GHA) para testar App Flip.
Para testar o App Flip no Google Assistant app, siga estas etapas:
- Acesse o Console do Actions e selecione seu projeto.
- Clique em Test na navegação da parte de cima.
- Acione o fluxo de vinculação de contas no app Google Assistant:
- Abra o Google Assistant app
- Clique em Configurações.
- Na guia Assistant, clique em Automação residencial.
- Clique em Adicionar(+).
- Selecione sua ação na lista de provedores. Será com o prefixo "[test]" na lista. Quando você seleciona sua ação [teste] de da lista, ele deve abrir seu aplicativo.
- Verifique se o aplicativo foi iniciado e comece a testar seu fluxo de autorização.
Para testar o App Flip no app Google Home, siga estas etapas:
- Acesse o Console do Actions e selecione seu projeto.
- Clique em Test na navegação da parte de cima.
- Acione o fluxo de vinculação de contas 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 ação smart home na lista de provedores. Ele será com o prefixo "[test]" na lista. Quando você seleciona sua ação [teste] de da lista, ele deve abrir seu aplicativo.
- Verifique se o aplicativo foi iniciado e comece a testar seu fluxo de autorização.