O Planilhas Google permite gravar
macros que duplicam uma
série específica de interações da interface definidas por você. Depois de gravar uma macro, é possível vinculá-la a um atalho de teclado no formato Ctrl+Alt+Shift+Number. Use esse atalho para executar novamente as etapas exatas da macro, geralmente em um lugar diferente ou em dados diferentes.
Também é possível ativar a macro no menu Extensões
> Macros do Planilhas.
Ao gravar uma macro, o Planilhas cria 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. Caso já exista um arquivo de projeto vinculado à planilha com esse nome, a função de macro será anexada a ele.
O Planilhas também atualiza automaticamente o manifesto do projeto de script
, gravando o nome e o atalho de teclado
atribuídos à macro.
Como cada macro gravada é definida inteiramente no Apps Script, é possível editá-las diretamente no editor de script do Apps Script. Você pode até mesmo criar macros do zero no Apps Script ou usar funções já escritas e transformá-las em macros.
Criar macros no Apps Script
É possível usar funções escritas no Apps Script como funções de macro. Uma maneira simples de fazer isso é importar uma função existente do editor do Planilhas.
Como alternativa, você pode criar macros no editor do Apps Script seguindo estas etapas:
- Na interface do Planilhas, selecione Extensões > Apps Script para abrir o script vinculado à planilha no editor de script do Apps Script.
- Escreva a função de macro. As funções de macro não podem receber argumentos nem retornar valores.
- Edite o manifesto do script para criar a macro e vinculá-la à função de macro. Atribua um nome e um atalho de teclado exclusivos.
- Salve o projeto de script. A macro estará 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 do 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 para o arquivo de 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 estará 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
um atalho de teclado a ela. Para fazer isso, edite o arquivo de manifesto e adicione outro elemento à propriedade
sheets.macros[].
Como alternativa, siga estas etapas para importar uma função como uma macro na interface do Planilhas:
- Na interface do 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. Também é possível mudar o nome da macro aqui. Por padrão, o nome é o mesmo da função.
- Clique em Atualizar para salvar a configuração da 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 Planilhas para mais detalhes sobre como os manifestos de macro do Planilhas são construídos.
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 repetitivas que precisam ser repetidas com frequência, com pouca ou nenhuma configuração. Para outras operações, considere usar um item de menu personalizado em vez disso.
- Lembre-se sempre 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, não é necessário criar macros que duplicam a mesma operação em um intervalo de células predefinido.
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 app da Web.
Definir macros em 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 são ignoradas pelos usuários desse complemento.
Distribuir macros em bibliotecas de script
Não é possível distribuir definições de macro usando bibliotecas do Apps Script .
Usar macros fora do Planilhas
As macros são um recurso exclusivo do Planilhas e não existem para o Documentos, o Formulários ou o Apresentações Google.