Macros do Planilhas Google

O Planilhas Google permite gravar macros que duplicam uma uma série específica de interações de IU que você define. Depois de gravar um você pode vinculá-la a um atalho de teclado no formulário Ctrl+Alt+Shift+Number: Use esse atalho para executar rapidamente a etapas macro exatas novamente, normalmente em um local diferente ou em dados diferentes. Você também pode ativar a macro nas Extensões do Planilhas Google. > Macros.

Quando você grava uma macro, o Planilhas Google cria automaticamente um Apps Script (a função macro) que replica as etapas da macro. A macro é adicionada a um projeto do Apps Script vinculado à planilha, em um arquivo chamado macros.gs. Caso haja um arquivo de projeto vinculado à planilha com esse nome, a função da macro está anexado a ela. O Planilhas Google também atualiza automaticamente o script o manifesto do projeto, gravando o nome e um atalho de teclado atribuído à macro.

Como cada macro gravada é definida inteiramente no Apps Script, você pode editá-las diretamente no editor do Apps Script. É possível até gravar macros do zero no Apps Script ou usar funções que você já escreveu e transformá-los em macros.

Como criar macros no Apps Script

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

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

  1. Na interface das Planilhas Google, selecione Extensões >. Apps Script para abrir vinculado à planilha no editor do Apps Script.
  2. Escreva a função macro. As funções de macro não devem aceitar argumentos e retornar nenhum valor.
  3. Edite o manifesto do script. para criar a macro e vinculá-la à função da macro. Atribua um atalho de teclado e nome.
  4. Salve o projeto de script. A macro estará disponível para uso na planilha.
  5. Teste a função da macro na planilha para verificar se ela funciona conforme o esperado.

Editando macros

Para editar as macros anexadas a uma planilha, faça o seguinte:

  1. Na interface 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 para o arquivo de projeto que contém a função da macro.
  3. Edite a função da macro para alterar o comportamento da macro.
  4. Salve o projeto de script. A macro estará disponível para uso na planilha.
  5. Teste a função da macro na planilha para verificar se ela funciona conforme o esperado.

Importação de funções como macros

Se já houver um script vinculado a uma página, você pode importar uma função no script como uma nova macro e atribuí-la um atalho de teclado. Você pode fazer isso editar o manifesto e adicionando outro elemento ao arquivo sheets.macros[].

Como alternativa, siga estas etapas para importar uma função como uma macro do Interface do app 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 na lista a função que você acabou de importar. Atribuir um teclado exclusivo atalho para a macro. Também é possível alterar o nome da macro aqui. o nome o padrão é o nome da função.
  6. Clique em Atualizar para salvar a configuração da macro.

Estrutura do manifesto para macros

O snippet de exemplo do arquivo de manifesto a seguir mostra a seção de um manifesto que define as macros das Planilhas Google. A seção sheets do manifesto define o nome e o atalho de teclado atribuídas à macro e o nome da função da 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 Planilhas. para mais detalhes sobre como os manifestos de macros das Planilhas são construídos.

Práticas recomendadas

Ao criar ou gerenciar macros no Apps Script, é recomendável siga as diretrizes a seguir.

  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 de programação que precisam ser repetidas frequentemente com pouca ou nenhuma configuração. Para outras operações, considere usando um item de menu personalizado.
  3. Lembre-se sempre de que os atalhos de teclado das macros devem ser únicos e que um determinado planilha pode ter apenas dez macros com atalhos por vez. Qualquer valor adicional só podem ser executadas em Extensões > Menu Macros.
  4. As macros que fazem alterações em uma única célula podem ser aplicadas a um intervalo de células selecionando primeiro o intervalo completo e, em seguida, ativando a macro. Isso significa que muitas vezes é desnecessário criar macros que dupliquem o mesma operação em um intervalo predefinido de células.

O que não é possível fazer

Há algumas restrições sobre o que é possível fazer com macros:

Usar macros fora de scripts vinculados

As macros são definidas em scripts vinculados a Planilhas Google específicas. Macro definições serão ignoradas se forem definidas em um script independente ou app da Web.

Definir macros em complementos do Planilhas

Não é possível distribuir definições de macro usando um complemento Planilhas. Definições de macro em um app Planilhas do complemento serão ignorados pelos usuários desse complemento.

Distribuir macros em bibliotecas de script

Não é possível distribuir definições de macro usando o Apps Script Bibliotecas.

Usar macros fora do Planilhas Google

As macros são apenas um recurso do Planilhas Google e não existem para os Documentos Google, Formulários ou Apresentações.