Dia: 17 de março de 2024

O que é o Google App Script? Neste post você verá sobre o Google App Script: um guia para iniciantes. O Google Apps Script é uma linguagem de programação com princípios e bases no Java Script. Ele também é baseada na nuvem para estender as funcionalidades dos aplicativos da Google. Então isso significa que você pode escrever pequenos programas com o Google App Script para estender todos os recursos das ferramentas padrões do Google Workspace. Ele é muito útil para automatizar processos do dia a dia e também para todos os seus fluxos de trabalho. Com ele você pode não só automatizar processos e tarefas repetitivas mas pode: Criar documentos Enviar e-mails Conectar Planilhas Google Criar programas e páginas. Integrar as ferramentas do Google Você pode ir muito além do que podemos imaginar. A cada dia que trabalhamos com ele podemos aprender algo novo a se fazer e ter novos insights de automações ou funcionalidades para nossos documentos. Primeira interação no Google App Script Nesse post iremos passar por um tutorial iniciante de como ter sua primeira interação com o Google App Script. Vamos escrever nosso primeiro script vinculado a nossa Planilha Google. Geralmente chamamos esse tipo de script de "script vinculado a contêiner" pois criaremos ele dentro de um documento que vamos trabalhar. Claro que isso não se limita ao documento que estamos. Ele pode ir muito mais além disso, ele é extremamente poderoso em suas integrações e dinâmicas. Acessando o Apps Script Vamos colocar a mão na massa? Pois bem, vamos escrever nosso primeiro código bem simples e extremamente básico. Iria usar o famoso "Hello world" da programação e usado pela maioria dos professores de informática, mas vamos mudar um pouquinho. Nessa abordagem vamos escrever "Bem vindo"...Muito original não é mesmo? Comece criando uma Planilha do Google em seu drive ou usando os métodos que já ensinei aqui nesta plataforma. Em seguida vamos abrir o nosso editor de script vinculado a nossa planilha. Basta ir no menu superior em "Extensões" e depois em "Apps Script": Com isso será aberto uma nova aba em seu navegador e você será direcionado para a página inicial do Google App Script. Nesta página terá todos os principais recursos que você precisa para criar o seu primeiro código. Todos de forma bem intuitiva e na própria interface desta janela. Ele é o editor de script da Google, chamamos ele de GAS que é a abreviação de Google App Script. Nele temos o menu, os arquivos, bibliotecas, serviços, todos os controles e o nosso código. Funções no Google App Script Por padrão ele abre esta janela onde será aberto também um único arquivo do Google App Script (code.gs) e um pequeno bloco de código padrão myFunction() como esse: function myFunction() { } Nesta janela de código, sempre entre as chaves e após a função myFunction(). Você pode escrever as linhas de código que deseja para fazer sua automação ou funcionalidade desejada. Então vamos colocar uma mensagem, seguimos em frente e colocaremos algo para nos dar boas vindas quando executarmos esse script. Para fazermos isso utilizaremos uma classe chamada Browser. Escreva a seguinte linha de código para que você tenha isso em sua janela de código: function myFunction() { Browser.msgBox("Bem vindo"); } Agora, antes de executarmos nosso código, vamos nomear esse projeto. Clique no nome de seu projeto, que vem como padrão "Projeto sem título" na parte superior esquerda: Sinta-se livre para colocar o nome que deseja, irei seguir e colocar o nome "Meu primeiro Script" depois é só clicar em Renomear. Desta forma já temos o nosso arquivo com o nome que desejamos e podemos seguir para executa-lo. Vamos executar o código que acabamos de escrever? Clique em "Executar" no menu superior onde temos os controles. Autorização do Google App Script O Google App Script possui algumas proteções de segurança robustas para reduzir o risco de aplicativos não identificados. Então sempre que executarmos um novo método ou classe em nosso código precisamos dar as permissões para que ele seja executado. Por isso devemos passar sempre por esse fluxo de trabalho de autorização, mas somente quando autorizamos nossos códigos para ser executados pela primeira vez. Clicando no botão executar nos controles do código pela primeira vez, será solicitado a autorização à execução do Google App Script: Logo após clicar em "Revisar permissões" irá abrir outra janela. Nesta nova janela será mostrado quais permissões seu script/código precisa para que ele seja executado. Selecione seu e-mail na próxima tela que aparecer. Quando executar o Google App Script pela primeira vez, você poderá ver na tela uma mensagem como: “o aplicativo não foi verificado” e mais avisos sobre se realmente deseja continuar. Portanto clique em Permitir. Agora clique no botão "Avançado" no canto inferior esquerdo desta janela de permissões. Após isso clique em "Ir para o código de script Meu primeiro Script (inseguro)" na parte inferior da próxima tela para continuar. Lembrando que caso não dê a permissão, seu script não poderá interagir com sua planilha ou fazer qualquer outra funcionalidade que você deseje. Cuidados com Scripts de terceiros Caso esteja executando um código que foi fornecido por terceiros se certifique que a origem é confiável. Podemos fornecer acesso indesejado a todos os nossos arquivos. Tome muito cuidado pois com isso e podemos ser extremamente expostos e prejudicados. Já disse isso em uma aula no meu canal do Youtube e aconselho que você veja e tome atenção à isso. Todo o cuidado é pouco, sabemos que existem muitas pessoas maliciosas querendo nossos dados. No nosso caso, o script deseja visualizar e gerenciar suas Planilhas no Google Drive. Como sabemos do que se trata e foi nós que fizemos esse script, temos a certeza e sabemos que é seguro. Saída do código Logo após conceder as permissões e executar o código volte à sua Planilha Google para que você veja a caixa de mensagem com o que escrevemos em nosso código Google App Script: Em nosso primeiro código usamos a classe Browser. Esta classe fornece acesso a caixas de diálogo específicas das Planilhas Google. Os métodos estão disponíveis apenas para uso no contexto de uma Planilha Google. Existe várias classes e métodos que podemos usar, não só em nossos arquivos de planilhas mas em praticamente todos os serviços fornecidos pela Google. Clique em Ok ou no X para descartar essa mensagem. Viu que simples né, agora você já escreveu seu primeiro código em Google App Script.