Como estender o uso do Planilhas Google com complementos

O Planilhas Google é uma solução de gerenciamento solução de planilha eletrônica com colaboração em tempo real e ferramentas poderosas para visualizar, processar e comunicar dados.

Você pode estender as Planilhas com complementos que criam melhorias personalizadas no fluxo de trabalho, estabelecer conectividade com sistemas de terceiros e integrar seus dados do app Planilhas com outros aplicativos do Google Workspace, como Apresentações Google).

Você pode ver os complementos do Planilhas que outras pessoas desenvolveram no Google Workspace Marketplace.

O que você pode fazer

Estas são algumas coisas que você pode fazer com um complemento que estenda o Planilhas Google:

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

Estrutura da página

Uma planilha do Planilhas Google consiste em uma ou mais páginas. Cada folha é basicamente uma grade 2D de células na qual textos, números, links ou outros podem ser armazenados. Um grupo de uma ou mais células adjacentes é chamado de intervalo.

O serviço Planilhas do Apps Script oferece várias classes para representar estruturas organizacionais no app Planilhas (como Sheet e Range). Você pode usar essas para ler e modificar os dados e o comportamento das Planilhas.

Gatilhos

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

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

Funções personalizadas

O Planilhas Google tem vários funções integradas como SUM e AVERAGE, que podem ser invocados de dentro de uma célula das Planilhas Google. Os complementos do Planilhas Google podem definir funções personalizadas para suplementar 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 seja somente definições de funções personalizadas. As definições de funções personalizadas são compartilhados com outras pessoas publicando um complemento com as definições.

Como criar funções personalizadas de complementos

Qualquer função definida em um projeto de script de complemento pode ser usada como um função. Depois de implementar a função e instalar o complemento, pode chamar a função personalizada como qualquer outra função incorporada do Planilhas: em um Na célula da planilha, insira = seguido do nome da função e das parâmetros. Se não houver erros, o resultado retornado pela função será colocado na célula da planilha, transbordando para as células vizinhas conforme necessário.

Ao criar funções personalizadas em um complemento, você deve seguir as diretrizes gerais de funções personalizadas:

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

  • Ao nomear sua função, tente criar um nome exclusivo, talvez relacionado ao o nome do complemento. Se dois ou mais complementos instalados definirem a personalização com o mesmo nome, os usuários só podem usar uma delas.
  • Seu complemento deve 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 pode apresentar informações de preenchimento automático para o usuário. Além disso, considere fornecer documentação adicional do funções personalizadas no próprio complemento ou em uma página da Web de suporte a complementos.
  • As funções personalizadas que não são concluídas em menos de 30 segundos falham com um Internal error executing the custom function erro. Desenvolva um bom usuário experiência limitando a quantidade de processamento que você faz em uma função personalizada. Otimizar a função sempre que possível.
  • As funções personalizadas não podem usar serviços do Apps Script que exigem autorização. e falhar com um erro You do not have permission to call X service se isso de segurança. Use apenas o serviços permitidos na função personalizada.
  • Cada função personalizada em uma planilha resulta em uma chamada separada para o Apps Script servidores. Se um usuário tentar usar funções personalizadas em muitas células, a podem ser executadas lentamente. Para minimizar isso, mantenha suas funções personalizadas o mais simples possível. Se você precisar que a função execute tarefas complexas em processamento, não use uma função personalizada. Forneça essa funcionalidade por meio de um item de menu, uma caixa de diálogo ou uma interação com a barra lateral.

Macros do Planilhas

As macros permitem gravar ações retiradas do Planilhas Google e repeti-las mais tarde com um atalho do teclado. Quando um for criada em uma planilha, ela será adicionada como uma função de macro em um aplicativo Projeto de script vinculado a essa página. Para mais informações sobre macros, consulte Macros do Planilhas Google.

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