Se você usa o Google Apps, é provável que estejanão usá-los em toda a sua extensão. Com o Script do Google Apps, você pode adicionar menus e caixas de diálogo personalizados, escrever funções e macros personalizadas e criar complementos para estender o Google Docs, Planilhas e Apresentações.
O que é o script do Google Apps?
O Google Apps Script é um desenvolvimento baseado em nuvemplataforma para criar aplicativos da web personalizados e leves. Você pode criar aplicativos escaláveis diretamente no navegador que se integram sem esforço aos produtos do Google.
O Script do Google Apps usa a linguagem JavaScript ereúne a familiaridade do desenvolvimento web e dos produtos do Google em um só lugar, tornando-a uma ferramenta perfeita para personalizar aplicativos para sua empresa, organização ou apenas para automatizar tarefas mundanas.
Você pode criar dois tipos de scripts com o Script do Google Apps:
- Estar sozinho: Esses scripts não estão vinculados a nenhum serviço, comoDocumentos, 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 arquivos no Drive com nomes específicos ou ver quem tem acesso aos arquivos e pastas compartilhados no Drive.
- Limite: Eles estão vinculados a documentos, planilhas, formulários,ou arquivo Slides. Os scripts vinculados estendem a funcionalidade de um arquivo e executam ações somente 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 por e-mail notificações a qualquer momento em que uma célula específica de uma planilha é alterada.
Se você não conhece muito JavaScript, ou talvezvocê nunca ouviu falar disso antes, não deixe que isso o assuste ao desenvolver um script próprio. É super fácil começar a usar o Apps Script, pois 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 são, vamos em frentee crie seu primeiro script independente. Usaremos uma amostra 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 o GoogleScript ou JavaScript.
Acesse o Script do Google Apps. No canto superior esquerdo, clique no ícone do hambúrguer e clique em "Novo script".
Um novo projeto sem título é aberto com uma função vazia, mas, como estamos usando o código de exemplo do Google, você pode prosseguir e excluir todo o texto do arquivo.
Nota: Você precisa estar conectado à sua conta do Google para que este script funcione.
Depois de excluir o código pré-carregado no arquivo, cole o seguinte código:
//Initialize your function
function createADocument() {
// Create a new Google Doc named 'Hello, world!'
var doc = DocumentApp.create('Hello, world!');
// Access the body of the document, then add a paragraph.
doc.getBody().appendParagraph('This document was created by Google Apps Script.');
}
Antes de poder executar o código, você deve salvar o script. Clique em "Arquivo" e, em seguida, clique em "Salvar".
Renomeie o projeto para algo que o ajude a lembrar o que o script faz e, em seguida, pressione "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 através de uma janela pop-up após clicar em "Executar" pela primeira vez. Clique em "Revisar Permissões" para ver o que ele precisa acessar.
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 confiar neles. Clique em "Avançado" e, em seguida, clique em "Ir para CreateNewDoc" (ou o que você nomeou para esse script).
Revise as permissões exigidas pelo script e clique em "Permitir".
Ótimo! Agora, vá até o Drive e, se tudo der certo, o arquivo "Olá, mundo!" Deve estar lá. Clique duas vezes nele para abri-lo.
Ao abrir o arquivo, você verá a linha de texto do código adicionada ao seu documento.
Agora, se você deseja receber uma notificação por e-mail quando o documento é criado, pode adicionar mais algumas linhas de código para enviar uma para sua conta do Google automaticamente. Adicione as seguintes linhas de código após doc.getBody().appendParagraph('This document was created by Google Apps Script.'); mas antes da última chave } :
// Get the URL of the document. var url = doc.getUrl(); // Get the email address of the active user - that's you. var email = Session.getActiveUser().getEmail(); // Get the name of the document to use as an email subject line. var subject = doc.getName(); // Append a new string to the "url" variable to use as an email body. var body = 'Link to your doc: ' + url; // Send yourself an email with a link to the document. GmailApp.sendEmail(email, subject, body);
Clique no ícone "Executar".
Como você adicionou algumas linhas extras que exigem permissões adicionais, é necessário seguir o mesmo processo de antes. Clique em "Revisar permissões".
Clique em "Avançado" e clique em "Ir para CreateNewDoc".
Nota: Como o Google avisa sobre o lançamentoaplicativos não verificados, você receberá um e-mail de alerta de segurança notificando você também. O Google faz isso apenas no caso de você não estar concedendo 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 email com um link para o arquivo no seu Google Drive.
Clicar no link leva você diretamente ao arquivo, que fica dentro do seu Google Drive.
Como criar um script vinculado
Para o próximo exemplo, vamos criar um script vinculado para o Planilhas Google que analise uma planilha existente para entradas duplicadas em uma linha e as exclua.
Se você se lembra dos scripts anteriores, os scripts encadernados funcionam como um complemento para arquivos específicos. Portanto, para criar um, vamos abrir uma planilha do Google Sheet existente que contém pelo menos um ponto de dados duplicado.
Clique em "Ferramentas" e depois em "Editor de scripts".
O Script do Google Apps é aberto em uma nova guia com um script vazio. Desta vez, no entanto, o script está vinculado à planilha na qual é aberto.
Assim como antes, exclua a função vazia e cole o seguinte código:
//Removes duplicate rows from the current sheet.
function removeDuplicates() {
//Get current active Spreadsheet
var sheet = SpreadsheetApp.getActiveSheet();
//Get all values from the spreadsheet's rows
var data = sheet.getDataRange().getValues();
//Create an array for non-duplicates
var newData = [];
//Iterate through a row's cells
for (var i in data) {
var row = data[i];
var duplicate = false;
for (var j in newData) {
if (row.join() == newData[j].join()) {
duplicate = true;
}
}
//If not a duplicate, put in newData array
if (!duplicate) {
newData.push(row);
}
}
//Delete the old Sheet and insert the newData array
sheet.clearContents();
sheet.getRange(1, 1, newData.length, newData[0].length).setValues(newData);
}
Nota: Para que o script remova uma duplicata, todas as células na linha devem corresponder.
Salve e renomeie seu script e clique no ícone "Executar".
Novamente, como você encontrou no último script, vocêcriado, você deverá revisar as permissões exigidas pelo script e conceder acesso à sua planilha. Clique em "Revisar permissões" para ver qual acesso esse script deseja.
Aceite as instruções e clique em "Permitir" para autorizar o script.
Depois de terminar a execução, volte à sua planilha e, como mágica, todas as entradas duplicadas desaparecem do seu arquivo!
Infelizmente, se seus dados estiverem dentro de uma tabela, como no exemplo acima, esse script não redimensionará a tabela para caber no número de entradas nela.
Embora estes sejam dois bastante simplesComo exemplos de como usar o Apps Apps, as opções são quase ilimitadas e tudo depende do que você pode imaginar com esses recursos. Enquanto isso, vá para a página do GSuite Devs Github ou para o Digital Inspiration e confira a pilha de scripts de amostra que você pode implantar em seus próprios serviços para ter uma idéia melhor do que o Apps Script é realmente capaz de fazer.
