Conectar o AppSheet com o Apps Script

1. Introdução

Neste codelab, você vai criar um projeto do Apps Script chamado "Hello World" Em seguida, adicione uma função simples, logThis, que registra uma mensagem que foi transmitida a ele. Em seguida, você vai criar uma automação do AppSheet e pedir que ela chame o script. Depois que o script for chamado, você retornará ao editor do Apps Script e confirmará a execução dele.

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 no AppSheet que chame a função do script.
  • Como verificar se o script foi executado 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". Em seguida, adicione uma função simples, logThis, que registra uma mensagem que foi transmitida a ele.

  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 um novo nome.
  3. Atualize o script no editor da seguinte 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ê gera rapidamente um novo app do AppSheet com base em um exemplo copiado de uma planilha Google e o atualiza para chamar o projeto do Apps Script que você criou antes.

  1. Abra a planilha Exemplo de pedidos de camisa e clique em Fazer uma cópia para fazer o download e abrir uma cópia nas Planilhas Google. Você pode renomear a planilha se quiser (por exemplo, "Pedidos de camisas").
  2. Faça login no AppSheet.
  3. Na página "Meus apps", clique em + Criar um novo app. A caixa de diálogo Create a new app é exibida.
  4. Clique em Começar com seus próprios dados. Caixa de diálogo de criação de novo app.
  5. Se quiser, edite o nome do app e selecione uma categoria.
  6. Clique em Escolher seus dados.

Selecionando "Escolher seus dados" na nova caixa de diálogo de criação de app.

  1. Clique em google para acessar seu Google Drive.
  2. Navegue e selecione a planilha Pedidos de camisa que você copiou.

O AppSheet configura seu app. Janela de visualização 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, crie uma automação do AppSheet e chame o script.

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

5037cdd726e326e9.png

  1. Clique na etapa Enviar uma notificação para editá-la.
  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.

Selecionando "Ligar para um script" tipo de tarefa nas configurações de automação.

  1. No campo Apps Script Project, clique em Browse (ícone de arquivo).
  2. Navegue até o projeto do Apps Script Hello World no seu Drive e selecione-o.
  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 das funções disponíveis.

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

O campo Argumentos de função é exibido.

  1. No argumento msg, digite a seguinte expressão usando o Assistente de expressão: ‘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 de dispositivo móvel ou tablet para exibir o emulador do app.

68471f4646fc8fbe.png

  1. Adicione um novo pedido de camisa e clique em Salvar.
  2. Clique em Sincronizar para sincronizar as alterações.

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

5. Confirme a execução do Apps Script

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

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

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

6. Etapas adicionais opcionais

Como etapa adicional deste workshop, revise o projeto de exemplos do Apps Script e execute alguns dos exemplos no AppSheet.

Introdução aos exemplos do Apps Script

  1. Para começar, primeiro faça uma cópia do Apps Script Example Project.
  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 dos exemplos

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

Para saber mais sobre esse recurso importante, consulte Chamar o Apps Script de uma automação, que oferece uma visão geral detalhada, vídeos de recursos, tutoriais e um projeto do Apps Script que pode ser copiado com muitos exemplos de trabalho do AppSheet e do Apps Script.