Adicionar função personalizada no Planilhas Google: 5 etapas

2024 Autor: John Day | [email protected]. Última modificação: 2024-01-30 11:35

Tenho certeza de que em algum momento da sua vida você teve que usar um software de planilha como o Microsoft Excel ou o Google Sheets.

Eles são relativamente simples e diretos de serem usados, mas também muito poderosos e facilmente extensíveis.

Hoje, examinaremos o Planilhas Google e sua capacidade de adicionar código e funções personalizadas para que possamos estendê-lo.

Etapa 1: O que são funções?

Uma função é um pedaço de código que manipula os dados da planilha para calcular um novo valor automaticamente para nós. Um exemplo muito comum de tal função é SUM, que calcula a soma de uma coluna ou grupo de células.

Todo o software de planilha suporta muitas dessas funções que são pré-construídas nelas, mas também suportam a capacidade de estendê-las e escrever nossas próprias funções.

Etapa 2: como escrever uma função personalizada?

Para escrever uma função personalizada no Planilhas Google, usamos um recurso chamado Apps Script, que é uma plataforma de desenvolvimento rápido de aplicativos onde podemos escrever código em JavaScript diretamente no navegador que será executado em nossa planilha.

Para começar a escrever, podemos ir em Ferramentas> Editor de scripts no menu superior e isso abrirá o editor de código online.

Nele, ao ser aberto pela primeira vez, teremos um arquivo chamado Code.gs junto com uma função inicial em branco, chamada myFunction.

Como um exemplo inicial, vamos renomear esta função para DOUBLE e adicionar um parâmetro de entrada em sua declaração. Dentro do corpo da função, precisamos retornar um valor e, para este exemplo, vamos apenas multiplicar o valor de entrada por 2.

Agora podemos salvar o script e, se voltarmos à planilha e adicionarmos alguns dados a ela, podemos fazer referência a essa função em qualquer célula e enviar a referência da célula de dados como entrada para o valor.

Ao executar esta função, o Editor de planilhas do Google exibirá em breve uma mensagem de carregamento na célula, mas exibirá o valor retornado da função.

Etapa 3: limitações de função e preenchimento automático

Essas funções podem fazer o que quisermos, mas existem algumas limitações que precisamos seguir, como:

Os nomes devem ser exclusivos e diferentes daqueles usados pelas funções integradas. O nome não deve terminar com _ e os nomes das funções são geralmente escritos com letras maiúsculas, embora isso não seja obrigatório.

Cada função pode retornar um único valor como em nosso exemplo, mas também pode retornar uma matriz de valores. Essa matriz será então expandida em células adjacentes, desde que estejam vazias. Se não forem, será mostrado um erro.

A função que escrevemos é utilizável, mas para qualquer outra pessoa que venha a editar o documento, ela será desconhecida e o usuário precisará saber que existe para usá-la. Podemos corrigir isso adicionando a função à lista de preenchimento automático, da mesma forma que todas as funções integradas.

Para fazer isso, precisamos adicionar uma tag JsDoc @customfunction na frente da função como um comentário, onde neste comentário podemos escrever uma breve explicação do que nossa função faz.

Agora com o comentário adicionado, quando começarmos a escrever o nome da função, a função será oferecida pelo autocompletar, junto com a descrição da função.

Etapa 4: chamar serviços externos

O grande poder que essas funções possuem, vem da capacidade de chamar e interagir com outras ferramentas e serviços do Google como Traduzir, Mapas, conectar-se a um banco de dados externo, trabalhar com XML e outros. De longe, o recurso mais poderoso para mim é a capacidade de fazer uma solicitação HTTP externa para qualquer API ou página da web e obter dados usando o serviço UrlFetch.

Para demonstrar isso, colarei uma função que converterá dólares americanos em franco suíço, mas não assumirá a taxa de câmbio, mas, em vez disso, a recuperará de uma API externa.

A função também usa o serviço de cache integrado, onde não chamará a API para todos os cálculos, mas a chamará uma vez para o primeiro cálculo e, em seguida, armazenará esse valor no cache.

Todos os outros cálculos serão feitos com o valor em cache, de modo que o desempenho deles será muito melhorado e não atingiremos o servidor tão frequentemente, já que as taxas não mudam tão rapidamente.

Como a API retorna JSON, uma vez que obtemos a resposta do servidor, precisamos analisar o JSON em um objeto e podemos obter a taxa, multiplicá-la pelo valor de entrada e retornar o novo valor calculado para a célula.

Etapa 5: Próximas etapas

Se você achar isso interessante e quiser saber mais, deixarei links abaixo para recursos adicionais.

developers.google.com/apps-script/guides/s…

developers.google.com/apps-script

Se você gostou do Instructable, certifique-se de se inscrever em meu canal do YouTube, se ainda não o fez, e confira alguns dos meus outros Instructables.

Saudações e obrigado pela leitura.