Ampliar o Google Planilhas com complementos

O Google Planilhas é uma solução de planilha baseada na nuvem com colaboração em tempo real e ferramentas avançadas para visualizar, processar e comunicar dados.

É possível estender o Planilhas com complementos que criam melhorias personalizadas no fluxo de trabalho, estabelecem conectividade com sistemas de terceiros e integram os dados do Planilhas com outros aplicativos do Google Workspace, como o Apresentações.

Você pode conferir os complementos do Planilhas criados por outras pessoas no Google Workspace Marketplace.

O que você pode fazer

Confira algumas coisas que você pode fazer com complementos que estendem o Planilhas:

Os complementos do Planilhas são criados usando o Apps Script. Para saber mais sobre como acessar e gerenciar o Planilhas com o Apps Script, consulte Estender o Planilhas.

Estrutura da planilha

Uma planilha do Planilhas consiste em uma ou mais planilhas. Cada planilha é essencialmente uma grade 2D de células em que texto, números, links ou outros valores podem ser armazenados. Um grupo de uma ou mais células adjacentes é chamado de intervalo.

O serviço de planilha do Apps Script oferece várias classes para representar estruturas organizacionais no Planilhas, como Sheet e Range. Você pode usar essas classes para ler e modificar dados e comportamentos do Planilhas.

Gatilhos

Os acionadores do Apps Script permitem que um projeto de script execute uma função especificada quando determinadas condições são atendidas, como quando uma planilha é aberta ou quando um complemento é instalado.

Consulte Acionadores de complementos para mais informações sobre quais acionadores podem ser usados com complementos do Planilhas e quais restrições se aplicam ao uso deles.

Funções personalizadas

O Planilhas tem várias funções integradas como SUM e AVERAGE que podem ser invocadas em uma célula do Planilhas. Os complementos do Planilhas podem definir outras funções personalizadas para complementar essas funções integradas. Quando um usuário instala o complemento, todas as funções personalizadas definidas incluídas nele ficam disponíveis imediatamente. É possível que um complemento consista apenas em definições de funções personalizadas. As definições de funções personalizadas são compartilhadas principalmente com outras pessoas publicando um complemento que contenha as definições.

Criar funções personalizadas de complementos

Qualquer função definida em um projeto de script de complemento pode ser usada como uma função personalizada. Depois que a função for implementada e o complemento for instalado, você poderá chamar a função personalizada como qualquer outra função integrada do Planilhas: em uma célula da planilha, insira = seguido do nome da função e dos parâmetros necessários. Se não houver erros, o resultado retornado pela função será colocado na célula do Planilhas, transbordando para as células vizinhas conforme necessário.

Ao criar funções personalizadas em um complemento, siga as diretrizes gerais de funções personalizadas:

Além disso, as funções personalizadas definidas em complementos têm algumas considerações especiais:

  • Ao nomear sua função, tente criar um nome exclusivo, talvez relacionado ao nome do complemento. Se dois ou mais complementos instalados definirem funções personalizadas com o mesmo nome, os usuários só poderão usar um deles.
  • O complemento precisa comunicar claramente quais funções personalizadas ele oferece. Forneça comentários precisos do JSDoc para suas funções personalizadas para que o Apps Script possa apresentar informações de preenchimento automático ao usuário. Além disso, considere fornecer documentação adicional das funções personalizadas no próprio complemento ou em uma página da Web de suporte do complemento.
  • As funções personalizadas que não são concluídas em menos de 30 segundos falham com um erro Internal error executing the custom function. Crie uma boa experiência do usuário limitando a quantidade de processamento que você faz em uma função personalizada. Otimize a função quando possível.
  • As funções personalizadas não podem usar serviços do Apps Script que exigem autorização e falham com um erro You do not have permission to call X service se isso for tentado. Use apenas os serviços permitidos na sua função personalizada.
  • Cada função personalizada em um Planilhas resulta em uma chamada separada para os servidores do Apps Script. Se um usuário tentar usar funções personalizadas em muitas células, as funções poderão ser executadas lentamente. Para atenuar isso, mantenha suas funções personalizadas o mais simples possível. Se você precisar que a função execute um processamento complexo ou estendido, não use uma função personalizada. Em vez disso, forneça essa funcionalidade usando um item de menu, uma caixa de diálogo ou uma interação da barra lateral.

Macros do Planilhas

As macros permitem gravar ações realizadas no Planilhas e repeti-las mais tarde com um atalho de teclado. Quando uma macro é criada em um Planilhas, ela é adicionada como uma função de macro em um projeto do Apps Script vinculado a esse Planilhas. Para mais informações sobre macros, consulte Macros do Planilhas.

Infelizmente, as macros do Planilhas não podem ser distribuídas com complementos. Se você incluir uma definição de macro no manifesto de um complemento, ela não estará disponível para os usuários desse complemento.