Bem-vindo! Este blog será uma visão geral do Google App Script.

O Google Apps Script é uma plataforma de script baseada em nuvem que pode ser integrada ao espaço de trabalho do Google para estender a funcionalidade do Google Apps e criar aplicativos leves baseados em nuvem usando JavaScript.

Ele oferece um editor de código on-line fácil de usar diretamente no seu navegador e seus scripts são executados nos servidores do Google. Ele também fornece acesso a várias bibliotecas integradas, como Gmail, Agenda, Drive, etc.

Vantagens do App Script:

• Aumente sua produtividade automatizando tarefas repetitivas no Google Workspace.
• Adicione menus personalizados, caixas de diálogo e barras laterais ao Google Docs, Sheets e Forms.
• Escreva funções e macros personalizadas para o Planilhas Google.
• Publique aplicativos da Web — autônomos ou incorporados no Google Sites.
• Interaja com outros serviços do Google, incluindo AdSense, Analytics, Agenda, Drive, Gmail e Maps.
• Crie complementos e publique-os no Google Workspace Marketplace.

▹ Faça login em sua Conta do Google e acesse Google App Script aqui .
▹ É assim que o painel fica inicialmente.

▹ Clicar em Novo projeto o levará à página Editor de código.

▹ O editor de código possui múltiplas opções; vamos começar inserindo o Título do projeto .
▹ Por padrão, temos um Code.gsarquivo (Google Script Extension) que contém uma função JavaScript vazia myFunction().

Imprimindo Hello World no Google App Script

1. Adicione console.log(‘hello world’);dentromyFunction()

function myFunction() {
  console.log('hello world');
}

Gatilhos

Os acionadores permitem que o Apps Script execute uma função automaticamente quando ocorre um determinado evento, como a abertura de um documento. Ele passa a função disparada para um objeto de evento que contém informações sobre o contexto no qual o evento ocorreu. Existem 2 tipos de gatilhos.

• Acionadores simples são um conjunto de funções reservadas incorporadas ao Apps Script, como a função onOpen(e), que é executada quando um usuário abre um arquivo do Documentos, Planilhas, Apresentações ou Formulários Google.
• Gatilhos instaláveis ​​oferecem mais recursos do que gatilhos simples, mas devem ser ativados antes do uso.

Gatilho baseado em tempo no App Script

• Clique em New Project para criar um novo projeto

• Dê um nome ao seu projeto.

• Dentro de myFunction, escreva o código que deve ser executado pela trigger.

• Clique em Gatilhos no Menu e crie um gatilho.

• Escolha a configuração de acionador desejada e clique em Salvar , como exemplo, escolhi Origem do evento como acionada por tempo, Tipo de acionador como cronômetro de minutos e Intervalo de minuto como a cada minuto.

• Essa configuração executaria o código a cada minuto.
• Uma vez salvo, você pode visualizar todos os seus gatilhos na página Gatilhos . Usando o ícone de lápis, você pode modificar suas configurações de gatilho. Usando os três pontos, você pode excluir ou visualizar a execução.


• Clicar em qualquer um se os gatilhos exibirão os logs adicionados no código.

• Crie uma nova planilha do Google.
• Clique em Extensões e escolha Apps Script .

• Vamos tentar acionar nosso script de aplicativo na barra de menus.
• Crie um método onOpen()no script do aplicativo, ele será executado toda vez que um arquivo for aberto.
• A lógica a seguir criará uma opção Meu Menu na Barra de Menus. Isso terá Trigger App Script como um submenu.
• O segundo parâmetro .addItem()é o método a ser executado ao clicar no botão Trigger App Script na planilha do Google.
• Clique em Salvar .

function onOpen() {
  const googleSheet = SpreadsheetApp.getUi();
  googleSheet.createMenu('My Menu')
     .addItem('Trigger App Script', 'MenuClicked') //Adds MenuClicked menu
     .addToUi();
}

//This method will be executed on clicking MenuClicked option
function MenuClicked() {
  console.log('Trigger App script clicked.')
}

• Após atualizar a planilha do Google, você poderá ver o Menu criado pelo App Script.

• Clicar na opção Trigger App Script executará o Método MenuClicked no App script.
• Os logs de execução podem ser visualizados na página de execução.

• Crie um arquivo HTML clicando no ícone de adição e escolhendo HTML.
• Aqui, criei um Index.html que exibe Hello World.

• No Code.gsarquivo, adicione um método doGet(e). Como exemplo, retornei o Index.html

function doGet(e) {
  var htmlContent = HtmlService.createTemplateFromFile('Index');
  return htmlContent.evaluate();
}

• Para implantar o aplicativo, clique em Implantar e forneça uma descrição.
• Escolher Executar como eu (ID de e-mail) fornecerá o mesmo acesso que sua conta possui.
• Escolher Quem tem acesso como Qualquer pessoa permitirá que qualquer pessoa acesse o Web App.

• Clicar em Avançar mostrará o URL do aplicativo da Web usando o qual você pode acessar o conteúdo HTML.

• Você também pode retornar outros tipos de dados, como JSON ou XML.

▹ Este blog é principalmente para cobrir a visão geral básica e os recursos do script do Google App.
▹ O Google App Script é preenchido com muitos recursos e capacidades, e as combinações são ilimitadas.
▹ Com isso, muitas ações e automação podem ser executadas.