As APIs Home usam o OAuth 2.0 para conceder acesso a dispositivos na estrutura. O OAuth permite que um usuário conceda permissão a um app ou serviço sem expor expor as credenciais de login.
Se você já tiver um cliente OAuth verificado (por exemplo, de um app já publicado), poderá usá-lo para testar as APIs da Home sem configurar uma nova. Para mais informações, consulte Se você já tem um cliente OAuth.
Assinar o app
Primeiro, gere uma chave OAuth executando seu app em Android Studio. Quando você executa ou depura um app no Android Studio, ele gera automaticamente uma chave OAuth destinada ao desenvolvimento e à depuração. Consulte Android Studio: assinar seu build de depuração para uma explicação completa.
Quando o app estiver em execução:
Conecte seu dispositivo móvel à máquina local. Android Studio vai listar seus dispositivos conectados por número de modelo. Selecione seu dispositivo na lista e clique em Run project. Isso cria e instala o app de exemplo no seu dispositivo móvel.
Para instruções mais detalhadas, consulte Executar apps em um dispositivo de hardware no site para desenvolvedores Android.
Pare o app em execução.
Para conferir a impressão digital SHA-1 do certificado OAuth, siga as instruções detalhadas em Como configurar o OAuth 2.0 / aplicativos nativos / Android no site de ajuda do Google Cloud Console.
Configurar a tela de consentimento OAuth
- No console do Google Cloud, acesse o painel do seletor de projetos e selecione o projeto que você quer usar para criar credenciais do OAuth.
- Acesse a página APIs e serviços e clique em Credenciais no menu de navegação.
Se você ainda não tiver configurado a tela de consentimento para este projeto do Google Cloud, o botão Configurar tela de consentimento vai aparecer. Nesse caso, configure a tela de consentimento usando o procedimento a seguir. Caso contrário, avance para a próxima seção.
- Clique em Configurar tela de consentimento. A página Tela de consentimento do OAuth é exibida.
- Dependendo do seu caso de uso, selecione Internal ou External e clique em Create. O painel Tela de consentimento do OAuth é exibido.
- Insira informações na página de informações do app de acordo com as instruções na tela e clique em Salvar e continuar. O painel Scopes é exibido.
- Não é necessário adicionar escopos. Clique em Salvar e continuar. O painel Test users é exibido.
- Se você quiser adicionar usuários para testar o acesso ao app, clique em Adicionar usuários. O painel Adicionar usuários é exibido. Os usuários de teste têm o privilégio de conceder permissões no app.
- No campo vazio, adicione um ou mais endereços de e-mail da Conta do Google e clique em Adicionar.
- Clique em Salvar e continuar. O painel Resumo é exibido.
- Revise as informações da tela de consentimento do OAuth e clique em Voltar ao painel.
Consulte Como configurar a tela de consentimento OAuth no site de ajuda do Google Cloud Console para conferir todos os detalhes.
Registrar o app e criar credenciais
Para registrar o app para o OAuth 2.0 e criar credenciais do OAuth, siga as instruções em Como configurar o OAuth 2.0. Você precisa indicar o tipo de app, que é app nativo/Android.
Adicione a impressão digital SHA-1 que você recebeu ao assinar o app ao cliente OAuth configurado no console do Google Cloud seguindo as instruções em Como configurar aplicativos OAuth 2.0 / nativos no site de ajuda do console do Google Cloud.
Com o dispositivo móvel conectado à máquina local, selecione o dispositivo na lista e clique em Run project novamente para executá-lo. Para instruções mais detalhadas, consulte Executar apps em um dispositivo de hardware no site para desenvolvedores Android.
Se você já tiver um cliente OAuth
Se você já tiver um cliente OAuth verificado para um app publicado, use o cliente OAuth atual para testar as APIs Home.
O registro de Google Home Developer Console não é necessário para testar e usar as APIs Home. No entanto, você ainda vai precisar de um registro Developer Console aprovado para publicar o app, mesmo que tenha um cliente OAuth verificado de outra integração.
As seguintes considerações se aplicam:
Há um limite de 100 usuários ao usar um cliente OAuth existente. Para saber como adicionar usuários de teste, consulte Configurar a tela de consentimento OAuth. Independentemente da verificação do OAuth, há um limite de 100 usuários imposto pelas APIs Home que podem conceder permissões ao seu app. Essa limitação é suspensa após a conclusão do registro de Developer Console.
ODeveloper Console registration precisa ser enviado para aprovação quando você estiver pronto para restringir as permissões de tipo de dispositivo por meio do OAuth para preparar a atualização do app com as APIs Home.
Para apps Google Cloud que ainda estão com a verificação OAuth pendente, os usuários não podem concluir o fluxo OAuth até que a verificação seja concluída. As tentativas de conceder permissões vão falhar com o seguinte erro:
Access blocked: <Project Name> has not completed the Google verification process.