Os guias de início rápido explicam como configurar e executar um app que chama uma a API Google Workspace.
Os guias de início rápido do Google Workspace usam as bibliotecas de cliente da API para lidar com algumas do fluxo de autenticação e autorização. Recomendamos que você você usa as bibliotecas de cliente para seus próprios aplicativos. Este guia de início rápido usa um autenticação simplificada, adequada para um teste de nuvem. Para um ambiente de produção, recomendamos aprender sobre autenticação e autorização antes como escolher as credenciais de acesso adequados para seu app.
Crie um Google Apps Script que faz solicitações à API Google Chat.
Objetivos
- Configure o ambiente.
- Crie e configure o script.
- Execute o script.
Pré-requisitos
- Uma conta empresarial ou corporativa do Google Workspace com acesso ao Google Chat.
Configurar seu projeto do Cloud
Se você estiver usando um novo projeto do Google Cloud para concluir este guia de início rápido, faça o seguinte: configurá-lo e se adicionar como usuário de teste. Se você já concluiu essas etapas para seu projeto do Cloud, pule para a próxima seção.
Abrir o projeto do Cloud no console do Google Cloud
Abra o projeto do Cloud que você pretende usar, caso ele ainda não esteja aberto. para esta amostra:
- No console do Google Cloud, acesse a página Selecionar um projeto.
- Selecione o projeto do Google Cloud que você quer usar. Se preferir, clique em Criar projeto e siga as instruções na tela. Se você criar um projeto do Google Cloud, talvez seja necessário ativar o faturamento dele.
Ativar a API Chat
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
- No console do Google Cloud, acesse o menu > APIs e Serviços > Tela de permissão OAuth.
- Em Tipo de usuário, selecione Interno e clique em Criar.
- Preencha o formulário de registro do app e clique em Save and continue.
Por enquanto, ignore a adição de escopos e clique em Salvar e continuar. No futuro, quando você criar um aplicativo para usar fora de sua organização do Google Workspace, mude o Tipo de usuário para Externo. Em seguida, adicionar os escopos de autorização exigidos pelo app.
- Analise o resumo do registro do app. Para fazer mudanças, clique em Editar. Se o app estiver tudo certo, clique em Voltar para o painel.
Configurar o app Google Chat
Para chamar a API Google Chat, você precisa configurar uma app Google Chat. Para as solicitações de gravação, o Google Chat atribui o app Google Chat à interface usando: as seguintes informações.
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, insira
Chat API quickstart app
. - No campo URL do avatar, digite
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, insira
Em Recursos interativos, clique em Ativar recursos interativos. mude para a posição desativada para desativar os recursos interativos do App Chat.
Clique em Salvar.
Criar o script
- Acesse script.google.com/create para criar um novo script.
- Substitua o conteúdo do editor de script pelo seguinte código:
- Clique em Salvar
.
- Clique em Projeto sem título e digite Guia de início rápido e clique em Renomear.
Configurar o script
Copie o número do projeto do Cloud
- No console do Google Cloud, acesse o menu > IAM e Administrador > Configurações.
- No campo Número do projeto, copie o valor.
Vincular seu projeto do Google Cloud
- Abra o projeto do Apps Script.
- Clique em Configurações do projeto .
- Em Projeto do Google Cloud Platform (GCP), clique em Mudar projeto.
- Em Número do projeto do GCP, cole o número do projeto do Google Cloud.
- Clique em Configurar projeto.
Ativar a API Google Chat
- Abra o projeto do Apps Script.
- Clique em Configurações do projeto .
- Em Configurações gerais, ative a opção Mostrar "appsscript.json". arquivo de manifesto no editor.
- Clique em Editor
appscript.json
e substitua o conteúdo pelo seguinte código:
, selecione o
Executar a amostra
No editor do Apps Script, clique em Executar.
A primeira vez que você executar o exemplo, ele solicitará que você autorize o acesso:
- Clique em Revisar permissões.
- Escolha uma conta.
- Clique em Permitir.
O registro de execução do script aparece na parte inferior da janela.