Macros do Planilhas Google

Com as Planilhas Google, é 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, o Planilhas Google 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. 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 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.

Como criar macros no Apps Script

É possível usar funções escritas em Apps Script como funções de macro. A maneira mais fácil de fazer isso é importar uma função do editor do Google Sheets.

Como alternativa, você pode criar macros no editor do Apps Script seguindo estas etapas:

  1. Na interface do usuário das Planilhas Google, selecione Extensões > Apps Script para abrir o script vinculado à planilha no editor do Apps Script.
  2. Escreva a função de macro. As funções de macro não podem receber argumentos nem retornar valores.
  3. Edite o manifesto do script para criar a macro e vinculá-la à função de macro. Atribua a ele um atalho de teclado e um nome exclusivos.
  4. Salve o projeto de script. A macro fica disponível para uso na planilha.
  5. 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:

  1. Na interface do usuário das Planilhas Google, selecione Extensões > Macros > Gerenciar macros.
  2. Encontre a macro que você quer editar e selecione > Editar macro. Isso abre o editor do Apps Script no arquivo do projeto que contém a função de macro.
  3. Edite a função de macro para mudar o comportamento dela.
  4. Salve o projeto de script. A macro fica disponível para uso na planilha.
  5. 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 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 usuário do Planilhas:

  1. Na interface das Planilhas Google, selecione Extensões > Macros > Importar.
  2. Selecione uma função na lista apresentada e clique em Adicionar função.
  3. Selecione para fechar a caixa de diálogo.
  4. Selecione Extensões > Macros > Gerenciar macros.
  5. 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.
  6. 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 Google Sheets. 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.

  {
    ...
    "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, recomendamos que você siga estas diretrizes.

  1. 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.
  2. 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.
  3. 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.
  4. 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 Google específicas. As definições de macro são ignoradas se definidas em um script independente ou em um web app.

Definir macros em complementos do Planilhas

Não é possível distribuir definições de macro usando um complemento do Google Sheets. 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 macros usando bibliotecas do Apps Script.

Usar macros fora das Planilhas Google

As macros são um recurso exclusivo das Planilhas Google e não estão disponíveis nos apps Documentos, Formulários ou Apresentações Google.