A vinculação de apps do Google baseada no OAuth permite que os usuários vinculem as contas deles com facilidade e rapidez no sistema de autenticação às Contas do Google. Se o app for instalado no smartphone do usuário quando ele iniciar o processo de vinculação da conta, ele será virado para o app e receberá a autorização do usuário.
Essa abordagem oferece um processo de vinculação mais rápido e fácil, já que o usuário não precisa inserir novamente o nome de usuário e a senha para autenticação. Em vez disso, o App Flip usa as credenciais da conta do usuário no aplicativo. Depois de vincular a Conta do Google ao aplicativo, o usuário pode aproveitar as integrações que você desenvolveu.
Você pode configurar o App Flip em apps iOS e Android.
Requisitos
Para implementar o App Flip, você precisa atender aos seguintes requisitos:
- É preciso ter um app Android ou iOS.
- É necessário ter, gerenciar e manter um servidor OAuth 2.0 compatível com o fluxo de código de autorização do OAuth 2.0.
Para mais informações sobre o fluxo do código de autorização de vinculação do OAuth, consulte Implementar seu servidor OAuth.
Diretrizes de design
Nesta seção, descrevemos os requisitos de design e as recomendações para a tela de consentimento da vinculação da conta do AppFlip. Depois que o Google chamar o app, ele exibirá a tela de consentimento ao usuário.
Requisitos
- Você precisa comunicar que a conta do usuário está sendo vinculada ao Google, e não a um produto específico, como o Google Home ou Google Assistente.
Recomendações
Portanto, recomendamos que você faça o seguinte:
Exibir 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 dizer ao usuário quais dados o Google exige e por quê.
Call-to-action clara. Insira uma call-to-action clara na tela de consentimento, como "Aceitar e vincular". Isso ocorre porque os usuários precisam entender quais dados eles precisam compartilhar com o Google para vincular as contas.
Opção de cancelamento. Ofereça aos usuários a opção de voltar ou cancelar.
Capacidade de desvincular. Ofereça um mecanismo para os usuários desvincularem, como um URL para as configurações da conta na plataforma. Se preferir, inclua um link para a Conta do Google em que os usuários possam gerenciar a conta vinculada.
É possível mudar a conta de usuário. Sugerir um método para os usuários trocarem de conta. Isso é útil principalmente quando os usuários costumam 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 o usuário possa fazer login na conta desejada com vinculação do OAuth e o fluxo implícito.
Inclua seu logotipo. Exiba o logotipo da sua empresa na tela de consentimento. Use suas diretrizes de estilo para inserir o logotipo. Se você também quiser exibir o logotipo do Google, consulte Logotipos e marcas registradas.
Configurar para o App Flip com base em OAuth
As seções a seguir descrevem os pré-requisitos do App Flip com base em OAuth e como configurá-lo no console do Actions.
Criar uma ação e configurar um servidor OAuth 2.0
Antes de configurar o App Flip, faça o seguinte:
- Crie uma ação. Para criar uma ação, siga as instruções na seção Criar um projeto.
- Configure um servidor OAuth 2.0. Para mais informações sobre como configurar um servidor OAuth, consulte Implementar a vinculação de conta OAuth.
Configurar o App Flip no Console do Actions
A seção a seguir descreve como configurar o App Flip no Console do Actions.
- Clique em Desenvolver na navegação superior. Em seguida, clique em Vinculação de contas no painel de navegação à esquerda.
- Alterne o botão ao lado de Vinculação de contas.
- Em Criação de conta, selecione Não, só quero permitir a criação de conta no meu site.
- Clique em Próxima.
- Em Tipo de vinculação, selecione OAuth e Código de autorização nos menus suspensos.
- Clique em Próxima.
- Preencha todos os campos em Informações do cliente OAuth. Se o App Flip não for compatível, o OAuth normal será usado como substituto.
- Clique em Próxima.
- Em Usar seu aplicativo para vinculação de conta (opcional), marque Ativar para iOS.
- Preencha o campo Universal Link. Para mais informações sobre links universais, consulte Como permitir que aplicativos e sites vinculem seu conteúdo .
- Se você quiser configurar o cliente, adicione escopos e clique em Adicionar escopo em Configurar seu cliente (opcional). Caso contrário, clique em Próxima.
- Em "Instruções de teste", digite
test(ou qualquer outra string) como um marcador. Preencher esse campo com uma conta de teste só será necessário se você realmente estiver enviando sua ação para publicação. - Clique em Salvar.
Prossiga para a próxima seção para implementar o App Flip no seu app iOS ou Android.
Implementar o App Flip nos seus aplicativos 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.
Testar o App Flip no dispositivo
Agora que você criou uma ação e configurou o App Flip no console e no app, pode testá-lo no dispositivo móvel. Você pode usar o app Google Assistente para testar o App Flip.
Para testar o App Flip no app Google Assistente, siga estas etapas:
- Acesse o console do Actions e selecione seu projeto.
- Clique em Testar na navegação superior.
- Acione o fluxo de vinculação da conta no app Google Assistente:
- Abra o app Google Assistente.
- Clique em Configurações.
- Na guia do Assistente, clique em Automação residencial.
- Clique em Add(+).
- Selecione sua ação na lista de provedores. Ele será prefixado com “[test]” na lista. Quando você selecionar a ação [test] na lista, seu app será aberto.
- Verifique se o aplicativo foi lançado e comece a testar o fluxo de autorização.