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 precisar 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 Home sem configurar um novo. Para mais informações, consulte Se você já tem um cliente OAuth cliente.
Assinar o app
Primeiro, gere um certificado de depuração executando o app em Android Studio. Ao executar ou depurar um app em Android Studio, ele gera automaticamente um certificado de depuração destinado ao desenvolvimento e à depuração. Consulte Android Studio: assinar sua versão de depuração build para uma explicação completa.
Depois que o app estiver em execução:
Conecte seu dispositivo móvel à máquina local. Android Studio vai listar os dispositivos conectados pelo número do modelo. Selecione seu dispositivo na lista e clique em Executar projeto. 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.
Interrompa o app em execução.
Receba a impressão digital SHA-1 do certificado de depuração seguindo as instruções detalhadas em Configurar o OAuth 2.0 / Aplicativos nativos / Android no site de ajuda do console do Google Cloud.
Configurar a tela de permissão 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 configurou a tela de permissão para esse projeto do Google Cloud, o botão Configurar tela de permissão vai aparecer. Nesse caso, configure a tela de permissão usando o procedimento a seguir. Caso contrário, avance para a próxima seção.
- Clique em Configurar tela de permissão. A página Tela de permissão OAuth é exibida.
- Dependendo do seu caso de uso, selecione Interno ou Externo e, em seguida, clique em Criar. O painel Tela de permissão 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 Escopos é exibido.
- Não é necessário adicionar escopos. Clique em Salvar e continuar. O painel Usuários de teste é exibido.
- Clique em Público-alvo e no botão + ADICIONAR USUÁRIOS.
- Insira o endereço de e-mail do usuário de teste e clique no botão SALVAR.
- Clique em Salvar e continuar. O painel Resumo é exibido.
- Revise as informações da tela de permissão OAuth e clique em Voltar ao painel.
Consulte Configurar a tela de permissão OAuth screen no site de ajuda do console do Google Cloud para mais 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 fornecidas em Configurar o OAuth 2.0. Você precisará indicar o tipo de app, que é nativo/app 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 Configurar o OAuth 2.0 / Aplicativos 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 Executar projeto 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á tem um cliente OAuth
Se você já tiver um cliente OAuth verificado para um app publicado, poderá usar o cliente OAuth atual para testar as APIs Home.
O registro Google Home Developer Console não é necessário para testar e usar as APIs Home. No entanto, você ainda precisará de um registro aprovado Developer Console para publicar seu 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. Para informações sobre como adicionar usuários de teste, consulte Configure a tela de permissão OAuth. Independente da verificação do OAuth, há um limite imposto pelas APIs Home de 100 usuários que podem conceder permissões ao seu aplicativo. Essa limitação é removida após a conclusão do Developer Console registro.
Developer Console do console para desenvolvedores deve ser enviado para aprovação quando você estiver pronto para restringir concessões de tipo de dispositivo pelo OAuth em preparação para atualizar seu app com as APIs Home.
Para Google Cloud apps que ainda estão pendentes de verificação do OAuth, os usuários não podem concluir o fluxo do 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.