Como turbinar seu Google Apps com o Editor de scripts

Se você usa o Google Apps, é provável que não os esteja usando em toda a sua extensão. Com o Google Apps Script, você pode adicionar menus e caixas de diálogo personalizados, escrever funções e macros personalizadas e criar complementos para estender o Documentos, Planilhas e Apresentações Google.

O que é o Script do Google Apps?

O Google Apps Script é uma plataforma de desenvolvimento baseada em nuvem para a criação de aplicativos da web leves e personalizados. Você pode criar aplicativos escalonáveis ​​diretamente no navegador que se integram facilmente aos produtos do Google.

O Apps Script usa a linguagem JavaScript e reúne a familiaridade do desenvolvimento da web e dos produtos do Google em um só lugar, tornando-o uma ferramenta perfeita para personalizar aplicativos para sua empresa, organização ou apenas para automatizar tarefas rotineiras.

Você pode fazer dois tipos de scripts com o Script do Google Apps:

• Autônomo: esses scripts não estão vinculados a nenhum serviço, como Documentos, Planilhas ou Apresentações Google. Eles podem executar funções em todo o sistema, como macros. Eles não são ideais para compartilhar com um público mais amplo, porque você precisa copiar e colar o código para usá-los. Os exemplos incluem pesquisar seu Drive em busca de arquivos com nomes específicos ou ver quem tem acesso aos seus arquivos e pastas compartilhados no Drive.
• Vinculado: estão vinculados a um arquivo do Documentos, Planilhas, Formulários ou Apresentações Google. Os scripts vinculados estendem a funcionalidade de um arquivo e executam ações apenas nesse arquivo específico. Os exemplos incluem a adição de menus personalizados, caixas de diálogo e barras laterais a um serviço ou script que envia notificações por e-mail sempre que uma célula específica em uma planilha é alterada.

Se você não conhece muito JavaScript, ou talvez nunca tenha ouvido falar dele antes, não deixe que isso o assuste de desenvolver seu próprio script. É muito fácil começar a usar o Apps Script, pois ele fornece uma grande quantidade de documentação e exemplos para você testar por conta própria. Abaixo estão alguns exemplos simples para ajudá-lo a entender como eles funcionam.

Como criar um script autônomo

Agora que você sabe o que eles são, vamos criar seu primeiro script autônomo. Estaremos usando um exemplo de código do Google para nos ajudar a dar o pontapé inicial e forneceremos explicações para as linhas de código se você não estiver familiarizado com GoogleScript ou JavaScript.

Vá para o  Google Apps Script . No canto superior esquerdo, clique no ícone de hambúrguer e em “Novo script”.

Um novo projeto sem título é aberto com uma função vazia dentro, mas como estamos usando um código de amostra do Google, você pode ir em frente e excluir todo o texto do arquivo.

Observação:  você precisa estar conectado à sua conta do Google para que este script funcione.

Depois de excluir o código que está pré-carregado no arquivo, cole o seguinte código:

// Inicialize sua função
 function createADocument () {
 
// Crie um novo Documento Google com o nome 'Hello, world!'
 var doc = DocumentApp.create ('Olá, mundo!');
 
// Acesse o corpo do documento e adicione um parágrafo.
 doc.getBody (). appendParagraph ('Este documento foi criado pelo Google Apps Script.');
 }

Antes de executar o código, você deve salvar o script. Clique em “Arquivo” e depois em “Salvar”.

Renomeie o projeto para algo que o ajude a lembrar o que o script faz e clique em “OK”.

Para executar seu código, clique no ícone de reprodução localizado na barra de ferramentas.

Você terá que conceder ao script algumas permissões para acessar sua conta do Google por meio de uma janela pop-up depois de clicar em “Executar” pela primeira vez. Clique em “Rever permissões” para ver o que precisa de acesso.

Como este não é um aplicativo verificado pelo Google, você receberá outro aviso. Basicamente, diz que, a menos que você conheça o desenvolvedor (nós), só prossiga se você confiar nele. Clique em “Avançado” e, em seguida, clique em “Ir para CreateNewDoc” (ou qualquer outro nome que você deu a este script).

Revise as permissões que o script requer e clique em “Permitir”.

Ótimo! Agora, vá para o seu Drive e, se tudo deu certo, a mensagem “Olá, mundo!” arquivo deve estar lá. Clique duas vezes nele para abri-lo.

Ao abrir o arquivo, você verá a linha de texto do código adicionado ao seu documento.

Agora, se você deseja receber uma notificação por e-mail quando o documento for criado, você pode adicionar mais algumas linhas de código para enviar uma para sua conta do Google automaticamente. Adicione as seguintes linhas de código depois,  doc.getBody().appendParagraph('This document was created by Google Apps Script.'); mas antes da última chave } :

// Obtenha o URL do documento.
var url = doc.getUrl ();
// Obtenha o endereço de e-mail do usuário ativo - é você.
var email = Session.getActiveUser (). getEmail ();

// Obtenha o nome do documento para usar como uma linha de assunto de email.
var subject = doc.getName ();

// Anexe uma nova string à variável "url" para usar como corpo de e-mail.
var body = 'Link para seu documento:' + url;

// Envie para você mesmo um e-mail com um link para o documento.
GmailApp.sendEmail (e-mail, assunto, corpo);

Clique no ícone “Executar”.

Como você adicionou algumas linhas extras que requerem permissões adicionais, você precisa passar pelo mesmo processo de antes. Clique em “Rever permissões”.

Clique em “Avançado” e, em seguida, clique em “Ir para CreateNewDoc”.

Nota:  Como o Google está avisando sobre o lançamento de aplicativos não verificados, você receberá um e-mail de alerta de segurança notificando-o também. O Google faz isso apenas para o caso de não ser você quem concede acesso a um aplicativo não verificado.

Revise o novo conjunto de permissões que o script requer e clique em “Permitir”.

Quando o documento é criado, você recebe um e-mail com um link para o arquivo em seu Google Drive.

Clicar no link leva você diretamente ao arquivo, que está dentro do seu Google Drive.

Como criar um script vinculado

Neste próximo exemplo, vamos criar um script vinculado para o Planilhas Google que analisa uma planilha existente em busca de entradas duplicadas em uma linha e as exclui.

Se você se lembra de antes, os scripts vinculados funcionam como um complemento para arquivos específicos; portanto, para criar um, vamos abrir uma planilha do Google já existente que contém pelo menos um ponto de dados duplicado.

Clique em “Ferramentas” e em “Editor de scripts”.

O Google Apps Script é aberto em uma nova guia com um script vazio. Desta vez, entretanto, o script está vinculado à planilha na qual é aberto.

Como antes, exclua a função vazia e cole o seguinte código:

// Remove linhas duplicadas da planilha atual.

 function removeDuplicates () {
// Obter planilha ativa atual
 var sheet = SpreadsheetApp.getActiveSheet ();
// Pega todos os valores das linhas da planilha
 var data = sheet.getDataRange (). getValues ​​();
// Crie uma matriz para não duplicados
 var newData = [];
// Iterar pelas células de uma linha
 para (var i em dados) {
   var row = data [i];
   var duplicate = false;
   for (var j in newData) {
    if (row.join () == newData [j] .join ()) {
     duplicado = verdadeiro;
    }
  }
// Se não for uma duplicata, coloque no array newData
 if (! duplicate) {
  newData.push (linha);
 }
}
// Exclua a planilha antiga e insira a nova matriz de dados
 sheet.clearContents ();
 sheet.getRange (1, 1, newData.length, newData [0] .length) .setValues ​​(newData);
}

Observação:  para que o script remova uma duplicata, todas as células da linha devem corresponder.

Salve e renomeie seu script e, em seguida, clique no ícone “Executar”.

Novamente, como você encontrou no último script criado, você terá que revisar as permissões que seu script requer e conceder a ele acesso à sua planilha. Clique em “Revisar permissões” para ver o acesso que este script deseja.

Aceite os prompts e clique em “Permitir” para autorizar o script.

Depois de terminar a execução, volte para sua planilha e, como num passe de mágica, todas as entradas duplicadas desaparecem de seu arquivo!

Infelizmente, se seus dados estiverem dentro de uma tabela – como no exemplo acima – este script não redimensionará a tabela para caber no número de entradas nela.

---

Embora esses sejam dois exemplos bastante simples de como usar o Apps Script, as opções são quase ilimitadas e tudo depende do que você pode imaginar com esses recursos. Mas, enquanto isso, vá para a página GSuite Devs Github  ou Digital Inspiration e verifique a pilha de scripts de amostra que você pode implantar em seus próprios serviços para ter uma ideia melhor do que o Apps Script é realmente capaz de fazer.