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.
- Acesse a página inicial do Apps Script e clique em + Novo projeto.
- Mude o título do projeto para
Hello World.
- Atualize o script no editor da seguinte forma:
function logThis(msg) {
Logger.log('Message from AppSheet was: ' + msg);
}
- 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.
- 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").
- Faça login no AppSheet.
- Na página "Meus apps", clique em + Criar um novo app. A caixa de diálogo Create a new app é exibida.
- Clique em Começar com seus próprios dados.
- Se quiser, edite o nome do app e selecione uma categoria.
- Clique em Escolher seus dados.
- Clique em google para acessar seu Google Drive.
- Navegue e selecione a planilha Pedidos de camisa que você copiou.
O AppSheet configura seu app.
- 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.
- Selecione Automação > Bots.
- Clique em + New Bot.
- Selecione o primeiro item na lista de sugestões: quando um registro de pedidos de camisa for criado ou atualizado, envie uma notificação.
- Clique na etapa Enviar uma notificação para editá-la.
- Mude o nome para
Call a script
.
- Em Configurações, mude o tipo de tarefa para Chamar um script.
- No campo Apps Script Project, clique em Browse (ícone de arquivo).
- Navegue até o projeto do Apps Script
Hello World
no seu Drive e selecione-o. - 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.
- Selecione logThis(msg) na lista Nome da função.
O campo Argumentos de função é exibido.
- No argumento msg, digite a seguinte expressão usando o Assistente de expressão: ‘Hello from AppSheet'
- Clique em Salvar para salvar o app.
- No painel de visualização, clique no ícone de dispositivo móvel ou tablet para exibir o emulador do app.
- Adicione um novo pedido de camisa e clique em Salvar.
- Clique em Sincronizar para sincronizar as alterações.
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.
- Volte para a página inicial do Apps Script e visualize o projeto Hello World.
- 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.
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
- Para começar, primeiro faça uma cópia do Apps Script Example Project.
- Clique no ícone de cópia.
- 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.