As Planilhas do Google oferecem diversas ferramentas para automatizar suas tarefas e tornar seu trabalho mais eficiente. Criar um botão no menu das Planilhas Google com o Google Apps Script é uma delas.
Se você não está familiarizado com o Google App Script ou GAS para os mais íntimos. Ele nos permite criar automações personalizadas para executar determinadas ações em nossa Planilha do Google.
Uma das funcionalidades que é muito interessante é que você pode criar com a ajuda do Google Apps Script um botão personalizado no menu da sua planilha.
Vamos ver como é simples fazer isso no Google Sheets?
Acessando o Google App Script
Com o Google Apps Script, você pode criar ferramentas personalizadas para otimizar seu trabalho no Google Sheets. Os botões personalizados no menu são apenas uma das muitas possibilidades que a integração do Google App Script nos oferece.
Explore as diversas funcionalidades do Apps Script e descubra como ele pode te ajudar a ser mais produtivo. Recentemente também falei de Como adicionar botão nas Planilhas Google para executar scripts. O que é muito interessante também, uma vez que você não precise entrar dentro da interface do GAS para acionar sua automação.
Vamos ao passo a passo para você abrir e criar um botão no menu das Planilhas Google. Com sua Planilha Google aberta acesse o editor de Script clicando em Extensões e depois em Apps Script. Conforme na imagem abaixo:
Com isso, será aberto uma nova aba em seu navegador. Nela você será direcionado para a página inicial do Google App Script. Também terá nesta mesma página todos os principais recursos que você irá precisa.
Como os controles e arquivos, além claro, de onde você colocará o seu código. Todos de forma bem intuitiva e fácil, na própria interface desta janela.
Adicionar código no Apps Script:
Onde estiver seu código myFunction como vimos na imagem anterior, será onde você irá substitua pelo código abaixo para adicionar alguma funcionalidade à sua automação antes de criarmos o menu em sua planilha.
function bemVindo() {
SpreadsheetApp.getUi().alert("Bem vindo");
}
Essa é uma função bem simples que quando for executada aparecerá a mensagem “Bem vindo” em sua planilha. 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. Leia mais sobre isso em meu post Google App Script: um guia para iniciantes.
Caso você dê as permissões ou até mesmo não apareça essa autorização nesse momento provavelmente você terá a mensagem em sua planilha assim:
Pronto, já temos o Script que desejamos executar agora basta criarmos o menu. Lembre-se que essa parte anterior pode ser qualquer função que você criou no Google App Script.
Criando botão no menu das Planilhas Google
Nessa parte vamos nos atentar a alguns pontos que desejamos e temos que fazer. Primeiro eu quero que sempre que a minha planilha seja aberta esse menu apareça nela então usaremos o gatilho onOpen.
Com ele o nosso código sempre será executado assim que nossa planilha for aberta ou recarregada.
- SpreadsheetApp.getUi(): Vamos iniciar chamando a planilha e e interface do usuário.
Também temos que dar um nome a esse menu, para isso basta adicionar o menu e seu nome em:
- createMenu(‘nome menu’): Aqui irei adicionar em “nome menu” o nome de minha empresa, no caso “Sheets Easy”.
Depois de criar o menu basta adicionarmos o item/função que desejamos. Ela será da seguinte forma:
- addItem(nome item, função executável): onde o nome do item é o que você deseja que apareça para o usuário e função executável o nome de sua função que nesse caso tínhamos nomeado ela de bemVindo.
Apenas um adendo a esse ponto, podemos adicionar mais de um item ao menu, também existe algumas outras configurações que podemos adicionar. Podemos abordar essa personalização em breve por aqui e lá no meu canal do YouTube.
Por fim devemos adicionar tudo isso à interface do usuário, para isso usamos a seguinte linha de código:
- addToUi(): Isso irá adicionar tudo que fizemos anteriormente a UI.
Ficamos com essa parte do código da seguinte forma:
function onOpen() {
SpreadsheetApp.getUi()
.createMenu('Sheets Easy')
.addItem('Bem Vindo', 'bemVindo')
.addToUi();
}
Observações: O botão só estará disponível para a planilha onde você criou o script. Se você compartilhar a planilha com outras pessoas, elas também poderão ver e usar o botão. Você pode modificar o código do script para realizar outras tarefas, como formatar células, enviar e-mails, etc.
Você pode acessar e verificar a documentação completa do Google App Script AQUI caso deseje ver mais possibilidades de automações e estudar sobre a ferramenta.
Executando o código para criar botão
Após adicionar todos os códigos que vimos anteriormente, você pode acionar o Script para que apareça o botão em sua planilha. Pode ser necessário fazer isso a primeira vez, pois o Google pode pedir as permissões para executar nossa automação.
Assim que você fizer a primeira execução do código, você não precisará mais executa-lo. Pois como colocamos a função onOpen() ela sempre será executada quando abrirmos a Planilha do Google.
Se você seguiu o passo a passo aqui você deve ter o seguinte código no Google App Script:
function bemVindo(){
SpreadsheetApp.getUi().alert("Bem Vindo!");
}
function onOpen(){
SpreadsheetApp.getUi()
.createMenu("Sheets Easy")
.addItem("Olá", "bemVindo")
.addItem("Bem vindo", "bemVindo")
.addToUi();
}
Assim que você terminou de executar o código onOpen() irá também já aparecer em sua planilha o botão “Sheets Easy” caso tenha colocado o mesmo nome que o meu:
Dessa forma você pode criar facilmente um botão no menu da sua Planilha Google usando o Google Apps Script. Esse recurso permite que você personalize a interface da sua planilha e adicione funcionalidades personalizadas.
Acionando suas automações de forma simples e bem mais rápida, além de não precisar colocar dentro de sua área de trabalho da planilha como também já abordei em um post aqui; Como adicionar botão nas Planilhas Google para executar scripts
Não perca tempo, comece a aproveitar os benefícios de ter um botão personalizado na sua Planilha Google hoje mesmo. Aprendendo sobre o Google Apps Script, se tornará um processo simples e acessível a qualquer usuário.
Espero que isso lhe ajude a melhorar a interface de sua Planilha Google e que você tenha gostado dessa funcionalidade.
No mais, lhe desejo muito sucesso hoje e sempre! 🙂
