Nível de programação: intermediário
Duração: 25 minutos
Tipo de projeto: app Google Chat
Objetivos
- Entenda o que a solução faz.
- Entenda o que os serviços do Apps Script fazem na solução.
- Configurar o ambiente.
- Configure o script.
- Execute o script.
Sobre esta solução
Programe uma reunião no Google Agenda em uma mensagem direta ou um espaço no Google Chat. É possível definir detalhes específicos para a reunião, como assunto, horário de início ou duração, ou usar as configurações padrão para agendamento instantâneo.
Como funciona
O script do app Chat usa comandos de barra e caixas de diálogo para receber detalhes da reunião dos usuários e programar um evento do Google Agenda. O script inclui configurações de reunião padrão que podem ser personalizadas para atender às suas necessidades.
Serviços do Apps Script
Essa solução usa os seguintes serviços:
- Serviço de agenda: cria o evento da agenda com base nas informações de reunião fornecidas.
- Serviço base: usa a classe
Session
para saber o fuso horário do script. O Agenda usa esse fuso horário ao programar o evento. - Serviço utilitários: formata a data do evento da agenda e codifica o ID do evento para receber o URL do evento.
Pré-requisitos
Para usar essa amostra, você precisa dos seguintes pré-requisitos:
- Uma Conta do Google (contas do Google Workspace podem exigir a aprovação do administrador).
- Um navegador da Web com acesso à Internet.
- um projeto do Google Cloud;
configurar o ambiente
Abra seu projeto do Cloud no console do Google Cloud.
Se ainda não estiver aberto, abra o projeto do Cloud que você pretende usar 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. Ou 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
Antes de usar as APIs do Google, é preciso ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.No projeto do Cloud, ative a API Google Chat.
Configurar a tela de permissão OAuth
Todos os apps de chat exigem uma configuração de tela de consentimento. A configuração da tela de permissão OAuth do seu app define o que o Google exibe aos usuários e registra o app para que você possa publicá-lo mais tarde.
- No console do Google Cloud, acesse 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 Salvar e continuar.
Por enquanto, é possível pular a adição de escopos e clicar em Salvar e continuar. No futuro, quando você criar um app para uso fora da sua organização do Google Workspace, será necessário alterar o Tipo de usuário para Externo e, em seguida, adicionar os escopos de autorização exigidos pelo app.
- Analise o resumo de registro do seu app. Para fazer mudanças, clique em Editar. Se o registro do app estiver correto, clique em Voltar para o painel.
Configurar o script
Criar o projeto do Apps Script
- Clique no botão a seguir para abrir o projeto Agendar reuniões no Google Chat do Apps Script.
Abrir o projeto - Clique em Visão geral .
- Na página de visão geral, clique em Fazer uma cópia .
Copie o número do projeto do Cloud.
- No console do Google Cloud, acesse Menu > IAM e administrador > Configurações.
- No campo Número do projeto, copie o valor.
Definir o projeto do Cloud do projeto do Apps Script
- No projeto copiado 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.
Criar uma implantação de teste
- No projeto copiado do Apps Script, clique em Implantar > Testar implantações.
- Copie o ID de implantação principal para usar em uma etapa posterior e clique em Concluído.
Configurar a API Chat
- No console do Google Cloud, acesse a página API Chat.
Acessar a API Chat - Clique em Configuração.
- Configure a API Chat com as seguintes informações:
- Nome:
Meeting Scheduler
- URL do avatar: adicione um URL que direcione para uma imagem com tamanho mínimo de 256 x 256 pixels.
- Descrição:
Quickly create meetings.
- Funcionalidade: marque as duas caixas para permitir que os usuários enviem mensagens diretamente ao app e o adicionem aos espaços.
- Configurações de conexão: clique em Apps Script e insira o código de implantação principal.
- Comandos de barra: adicione comandos de barra para
/help
e/schedule_Meeting
seguindo estas etapas:- Clique em Adicionar comando de barra e configure-o com as seguintes
informações:
- Nome:
/help
- ID do comando:
1
- Descrição:
Learn what this app does.
- Nome:
- Clique novamente em Adicionar comando de barra e configure-o com as seguintes
informações:
- Nome:
/schedule_Meeting
- ID do comando:
2
- Descrição:
Schedule a meeting.
- Marque a caixa Abre uma caixa de diálogo.
- Nome:
- Clique em Adicionar comando de barra e configure-o com as seguintes
informações:
- Permissões: selecione Pessoas e grupos específicos do seu domínio e digite seu endereço de e-mail.
- Nome:
- Clique em Salvar e atualize a página.
- Na página de configuração, em Status do app, defina o status como Ativo - disponível para os usuários.
- Clique em Salvar.
Executar o script
- Abra o Google Chat.
- Clique em Iniciar um chat .
- Pesquise o nome do app,
Meeting Scheduler
. - Envie uma mensagem inicial, como
hello
, para solicitar a autorização. Quando o app responder, clique em Configurar e autorize o app. Se a tela de permissão OAuth mostrar o aviso Este app não foi verificado, continue selecionando Avançado > Acessar {Nome do projeto} (não seguro).
Enviar
/schedule_Meeting
para o app.Na caixa de diálogo, adicione pelo menos um endereço de e-mail do convidado. É possível atualizar os outros campos ou usar as entradas padrão.
Clique em Enviar.
Para ver a reunião, clique em Abrir evento do Google Agenda.
Revisar o código
Para analisar o código do Apps Script para esta solução, clique em Ver código-fonte abaixo:
Ver o código-fonte
Code.gs
Dialog.gs
Utilities.gs
Colaboradores
Esta amostra é mantida pelo Google com a ajuda de especialistas do Google Developers.