Conectar o AppSheet com o Apps Script

1. Introdução

Neste codelab, você vai criar um projeto do Apps Script chamado "Hello World" e adicionar uma função simples, logThis, que registra uma mensagem transmitida a ela. Em seguida, crie uma automação do AppSheet e faça com que ela chame o script. Depois que o script for chamado, volte ao editor de script do Apps Script e confirme a execução.

O que você vai aprender

  • Como criar um projeto do Apps Script com uma função simples.
  • Como criar um app simples do AppSheet com base em uma planilha Google.
  • Como criar uma automação do AppSheet que chama a função de script.
  • Como verificar a execução bem-sucedida do script no AppSheet.

O que é necessário

  • Acesso ao ambiente de desenvolvimento do AppSheet (appsheet.com).
  • Acesso ao ambiente de desenvolvimento do Apps Script (script.google.com).

2. Crie um projeto do Apps Script

Primeiro, crie um projeto do Apps Script chamado "Hello World" e adicione uma função simples, logThis, que registra uma mensagem transmitida a ela.

  1. Acesse a página inicial do Apps Script e clique em + Novo projeto.
  2. Mude o título do projeto para Hello World. Caixa de diálogo "Renomear projeto" com o novo nome.
  3. Atualize o script no editor desta forma:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. Clique em Salvar projeto.

Para mais informações, consulte Criar e excluir projetos.

3. Criar um app do AppSheet

Em seguida, você vai gerar rapidamente um novo app do AppSheet com base em um exemplo de planilha Google copiado e atualizá-lo para chamar o projeto do Apps Script criado anteriormente.

  1. Abra a planilha Exemplo de pedidos de camisetas e clique em Fazer uma cópia para baixar e abrir uma cópia no Google Planilhas. Se quiser, renomeie a planilha (por exemplo,"Pedidos de camisetas").
  2. Faça login no AppSheet.
  3. Na página "Meus apps", clique em + Criar um novo app. A caixa de diálogo Criar um novo app vai aparecer.
  4. Clique em Começar com seus próprios dados. Caixa de diálogo "Criação de novo app".
  5. Se quiser, edite o nome do app e selecione uma categoria.
  6. Clique em Escolher seus dados.

Selecionar "Escolher seus dados" na caixa de diálogo de criação de apps.

  1. Clique em google para acessar o Google Drive.
  2. Navegue até a planilha Pedidos de camisetas que você copiou antes e selecione-a.

O AppSheet configura seu app. Janela de prévia inicial do app gerado.

  1. Clique em Personalizar seu app para abrir o app no editor do AppSheet.

4. Criar uma automação

Em seguida, você cria uma automação do AppSheet e faz com que ela chame o script.

  1. Selecione Automação > Bots.
  2. Clique em + Novo bot.
  3. Selecione o primeiro item na lista de sugestões: Quando um registro de pedidos de camisetas for criado ou atualizado, envie uma notificação.

5037cdd726e326e9.png

  1. Clique na etapa Enviar uma notificação para editar.
  2. Mude o nome para Call a script.

Etapas de automação para chamar um script.

  1. Em Configurações, mude o tipo de tarefa para Chamar um script.

Selecionar o tipo de tarefa "Chamar um script" nas configurações de automação.

  1. No campo Projeto do Apps Script, clique em Procurar (ícone de arquivo).
  2. Acesse e selecione o projeto do Apps Script Hello World no Drive.
  3. Clique em Selecionar e, se for preciso autorizar, clique em Autorizar e siga as instruções.

O projeto do Apps Script é adicionado, e o campo Nome da função é preenchido com uma lista de funções disponíveis.

  1. Selecione logThis(msg) na lista Nome da função. Selecionar a função do Apps Script "logThis()" no menu suspenso.

O campo Argumentos da função é exibido.

  1. Para o argumento msg, insira a seguinte expressão usando o Assistente de expressões: ‘Hello from AppSheet'

Adicionar argumentos à chamada de função do Apps Script.

  1. Clique em Salvar para salvar o app.
  2. No painel de visualização, clique no ícone dispositivo móvel ou tablet para mostrar o emulador de app.

68471f4646fc8fbe.png

  1. Adicione um novo pedido de camiseta e clique em Salvar.
  2. Clique em Sincronizar para sincronizar as mudanças.

Clique no ícone de sincronização no canto superior direito do painel de prévia para sincronizar com a fonte de dados.

5. Confirmar a execução do Apps Script

Depois que o script for chamado, volte ao editor de script do Apps Script e confirme a execução.

  1. Volte para a página inicial do Apps Script e confira o projeto Hello World.
  2. Clique em Execuções na barra de navegação para confirmar se a função logThis foi concluída. Clique em Atualizar se o registro não aparecer.

Visualizar registros de execução no ambiente do editor de script do Apps Script para verificar a execução da função na chamada do AppSheet.

6. Etapas adicionais opcionais

Como uma etapa adicional neste workshop, revise o projeto de exemplos do Apps Script e execute alguns exemplos do AppSheet.

Comece a usar os exemplos do Apps Script

  1. Para começar, faça uma cópia do Projeto de exemplos do Apps Script.
  2. Clique no ícone de cópia.
  3. Salve o novo projeto e clique em Executar para autorizar os apps no projeto.

Teste vários exemplos

  • createCalendarEvent(): crie um evento do Google Agenda.
  • createDoc(): cria automaticamente um novo documento.
  • createSheet(): crie uma nova página.
  • createSlideDeck(): crie uma apresentação de slides usando uma imagem e um texto.

Para mais informações sobre esse recurso importante, consulte Chamar o Apps Script em uma automação, que oferece uma visão geral detalhada, um vídeo sobre o recurso, tutoriais e um projeto do Apps Script copiável com muitos exemplos de funcionamento do AppSheet e do Apps Script.