Com o Google Planilhas, é possível gravar macros que duplicam uma série específica de interações da interface do usuário definidas por você. Depois de gravar uma
macro, você pode vinculá-la a um atalho do teclado no formato
Ctrl+Alt+Shift+Number. Use esse atalho para executar rapidamente as etapas exatas da macro novamente, geralmente em um lugar diferente ou com dados diferentes.
Você também pode ativar a macro no menu Extensões
> Macros das Planilhas Google.
Quando você grava uma macro, as Planilhas criam automaticamente uma função do Apps Script (a função de macro) que replica as etapas da macro. A função de macro é adicionada a um projeto do Apps Script vinculado à planilha, em um arquivo chamado macros.gs. Se já houver um arquivo de projeto vinculado à planilha com esse nome, a função de macro será anexada a ele.
As Planilhas Google também atualizam automaticamente o manifesto do projeto de script, registrando o nome e o atalho de teclado atribuídos à macro.
Como todas as macros gravadas são definidas inteiramente no Apps Script, é possível editá-las diretamente no editor de script do Apps Script. Você pode até mesmo escrever macros do zero no Apps Script ou pegar funções que já escreveu e transformá-las em macros.
Criar macros no Apps Script
É possível usar funções escritas em Apps Script como funções de macro. Uma maneira simples de fazer isso é importar uma função existente do editor das Planilhas.
Como alternativa, você pode criar macros no editor do Apps Script seguindo estas etapas:
- Na interface das Planilhas, selecione Extensões > Apps Script para abrir o script vinculado à planilha no editor do Apps Script.
- Escreva a função de macro. As funções de macro não podem ter argumentos nem retornar valores.
- Edite o manifesto do script para criar a macro e vincular à função dela. Atribua a ele um atalho de teclado e um nome exclusivos.
- Salve o projeto de script. A macro fica disponível para uso na planilha.
- Teste a função de macro na planilha para verificar se ela funciona como esperado.
Editar macros
Para editar macros anexadas a uma planilha, faça o seguinte:
- Na interface das Planilhas, selecione Extensões > Macros > Gerenciar macros.
- Encontre a macro que você quer editar e selecione > Editar macro. Isso abre o editor de script do Apps Script no arquivo do projeto que contém a função de macro.
- Edite a função de macro para mudar o comportamento dela.
- Salve o projeto de script. A macro fica disponível para uso na planilha.
- Teste a função de macro na planilha para verificar se ela funciona como esperado.
Importar funções como macros
Se já houver um script vinculado a uma planilha,
você poderá importar uma função no script como uma nova macro e atribuir a ela
um atalho de teclado. Para fazer isso, edite o arquivo de manifesto e adicione outro elemento à propriedade sheets.macros[].
Ou siga estas etapas para importar uma função como uma macro da interface do Planilhas:
- Na interface das Planilhas, selecione Extensões > Macros > Importar.
- Selecione uma função na lista apresentada e clique em Adicionar função.
- Selecione para fechar a caixa de diálogo.
- Selecione Extensões > Macros > Gerenciar macros.
- Localize a função que você acabou de importar na lista. Atribua um atalho de teclado exclusivo à macro. Você também pode mudar o nome da macro aqui. Por padrão, ele é o mesmo da função.
- Clique em Atualizar para salvar a configuração de macro.
Estrutura do manifesto para macros
O snippet de exemplo de arquivo de manifesto a seguir mostra a seção de um
manifesto que define macros
do Planilhas.
A seção sheets do manifesto define o nome e o atalho de teclado
atribuídos à macro e o nome da função de macro.
Os manifestos incluem outros componentes relacionados às propriedades do Apps Script. Os campos na chave sheets estão diretamente relacionados à funcionalidade
do Planilhas. Este exemplo é apenas uma parte de um arquivo de manifesto completo e não é um manifesto totalmente funcional.
{
...
"sheets": {
"macros": [{
"menuName": "QuickRowSum",
"functionName": "calculateRowSum",
"defaultShortcut": "Ctrl+Alt+Shift+1"
}, {
"menuName": "Headerfy",
"functionName": "updateToHeaderStyle",
"defaultShortcut": "Ctrl+Alt+Shift+2"
}]
}
}
Consulte o recurso de manifesto de macro do Google Sheets para mais detalhes sobre como eles são criados.
Práticas recomendadas
Ao criar ou gerenciar macros no Apps Script, siga estas diretrizes:
- As macros têm melhor desempenho quando são leves. Sempre que possível, limite o número de ações que uma macro realiza.
- As macros são mais adequadas para operações rotineiras que precisam ser repetidas com frequência e pouca ou nenhuma configuração. Para outras operações, considere usar um item de menu personalizado.
- Não se esqueça de que os atalhos de teclado de macro precisam ser exclusivos, e uma planilha só pode ter dez macros com atalhos por vez. Outras macros só podem ser executadas no menu Extensões > Macros.
- As macros que fazem mudanças em uma única célula podem ser aplicadas a um intervalo de células. Para isso, selecione o intervalo completo e ative a macro. Isso significa que muitas vezes é desnecessário criar macros que duplicam a mesma operação em um intervalo predefinido de células.
O que não é possível fazer
Há algumas restrições sobre o que você pode fazer com macros:
Usar macros fora de scripts vinculados
As macros são definidas em scripts vinculados a Planilhas específicas. As definições de macro são ignoradas se definidas em um script independente ou em um web app.
Definir macros nos complementos do Google Workspace para Planilhas
Não é possível distribuir definições de macro usando um complemento do Google Workspace para Planilhas. Todas as definições de macro em um projeto de complemento do Planilhas Google são ignoradas pelos usuários desse complemento.
Distribuir macros em bibliotecas de script
Não é possível distribuir definições de macros usando bibliotecas do Apps Script.
Usar macros fora das Planilhas
As macros são um recurso exclusivo das Planilhas, e não estão disponíveis para os apps Documentos, Formulários ou Apresentações Google.