Crie um aplicativo de linha de comando Java que faça solicitações para a API Google Chat.
Os tutoriais rápidos explicam como configurar e executar um app que chama uma API do Google Workspace. Este guia de início rápido usa uma abordagem de autenticação simplificada que é adequada para um ambiente de teste. Para um ambiente de produção, recomendamos que você aprenda sobre autenticação e autorização antes de escolher as credenciais de acesso adequadas para o app.
Este guia de início rápido usa as bibliotecas de cliente de API recomendadas do Google Workspace para processar alguns detalhes do fluxo de autenticação e autorização.
Objetivos
- Prepare o ambiente.
- Configure a amostra.
- Execute a amostra.
Pré-requisitos
- Java 1.8 ou mais recente.
- Gradle 7.0 ou mais recente.
- Um projeto do Google Cloud.
- Uma conta do Google Workspace para empresas ou empresas com acesso ao Google Chat.
Configurar o ambiente
Para concluir este guia de início rápido, configure seu ambiente.
Ativar a API
Antes de usar as APIs do Google, você precisa ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.No console do Google Cloud, ative a API Google Chat.
Configurar a tela de permissão OAuth
Se você estiver usando um novo projeto do Google Cloud para concluir este guia de início rápido, configure a tela de consentimento do OAuth. Se você já concluiu esta etapa para seu projeto do Cloud, pule para a próxima seção.
- No console do Google Cloud, acesse Menu > > Marca.
- Se você já tiver configurado o , poderá configurar as seguintes configurações da tela de consentimento do OAuth em Marca, Público-alvo e Acesso a dados. Se você receber a mensagem ainda não configurado, clique em Começar:
- Em Informações do app, em Nome do app, insira um nome para o app.
- Em E-mail para suporte do usuário, escolha um endereço de e-mail de suporte para que os usuários entrem em contato com você se tiverem dúvidas sobre o consentimento.
- Clique em Próxima.
- Em Público, selecione Interno.
- Clique em Próxima.
- Em Dados de contato, insira um endereço de e-mail para receber notificações sobre as mudanças no projeto.
- Clique em Próxima.
- Em Concluir, analise a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a política de dados do usuário dos serviços de API do Google.
- Clique em Continuar.
- Clique em Criar.
- Por enquanto, você pode pular a adição de escopos. No futuro, quando você criar um app para uso fora da sua organização do Google Workspace, será necessário mudar o Tipo de usuário para Externo. Em seguida, adicione os escopos de autorização necessários para o app. Para saber mais, consulte o guia completo Configurar a permissão OAuth.
Autorizar credenciais para um aplicativo para computador
Para autenticar usuários finais e acessar dados do usuário no app, crie um ou mais IDs do cliente OAuth 2.0. Um ID do cliente é usado para identificar um único app nos servidores OAuth do Google. Se o app for executado em várias plataformas, crie um ID do cliente separado para cada plataforma.- No console do Google Cloud, acesse Menu > > Clientes.
- Clique em Criar cliente.
- Clique em Tipo de aplicativo > App para computador.
- No campo Nome, digite um nome para a credencial. Esse nome é mostrado apenas no console do Google Cloud.
- Clique em Criar.
A credencial recém-criada aparece em "IDs de cliente OAuth 2.0".
- Salve o arquivo JSON baixado como
credentials.json
e mova-o para o diretório de trabalho.
Configurar o app Google Chat
Para chamar a API Google Chat, você precisa configurar um app do Google Chat. Para todas as solicitações de gravação, o Google Chat atribui o app do Google Chat na interface usando as informações a seguir.
No console do Google Cloud, acesse a página Configuração da API Chat:
Em Informações do aplicativo, insira as seguintes informações:
- No campo Nome do app, digite
Chat API quickstart app
. - No campo URL do avatar, insira
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - No campo Descrição, use
Quickstart for calling the Chat API
.
- No campo Nome do app, digite
Em Recursos interativos, clique em Ativar recursos interativos para desativar os recursos interativos do app do Chat.
Clique em Salvar.
Preparar o espaço de trabalho
No diretório de trabalho, crie uma nova estrutura de projeto:
gradle init --type basic mkdir -p src/main/java src/main/resources
No diretório
src/main/resources/
, copie o arquivocredentials.json
que você fez o download anteriormente.Abra o arquivo
build.gradle
padrão e substitua o conteúdo por este código:
Configure a amostra
No diretório
src/main/java/
, crie um novo arquivo Java com um nome que corresponda ao valormainClassName
no arquivobuild.gradle
.Inclua o seguinte código no novo arquivo Java:
Executar a amostra
Execute o exemplo:
gradle run
-
Na primeira vez que você executar o exemplo, será necessário autorizar o acesso:
- Faça login na sua Conta do Google, caso ainda não tenha feito. Se você tiver feito login em várias contas, selecione uma para usar na autorização.
- Clique em Aceitar.
O aplicativo Java é executado e chama a API Google Chat.
As informações de autorização são armazenadas no sistema de arquivos. Assim, na próxima vez que você executar o código de exemplo, não será necessário fazer a autorização.