Criando Código/Função Personalizada no Google Sheet Através do Apps Script

Com o Google Sheet é possível fazer muitas coisas, e uma delas é adicionar código personalizado (javascript) para criar funções exclusivas.

Acessando o Google Sheet

Para isso, primeiro você deve iniciar uma planilha, pode ser em branco ou já ter dados nela.

Para criar uma planilha, basta acessar este caminho: https://docs.google.com/spreadsheets/u/0/create

Acessando o Apps Script

Ao acessar sua planilha, você poderá visualizar na parte superior da tela, a guia de “Extensões > Apps Script”. Agora, basta clicar nele, que você vai ser direcionado para uma outra tela, onde poderá criar seus códigos personalizados.

Criando seu primeiro código

Nessa tela, você pode perceber que existe um campo para digitar seu código, caso já tenha algo ali, pode deletar, caso seja uma função apenas de exemplo.

Depois de colocar seu código personalizado, você deve clicar no ícone de “salvar”, como mostra a imagem abaixo:

Depois disso, sua função esta pronta para ser chamada dentro da sua planilha. Para isso, precisa usar o sinal de = junto ao nome da função que criou.

Exemplo de função

Se criou uma função chamada “ola_mundo”, como mostra abaixo:

function ola_mundo() {
  return "ola mundo, tudo bem?";
}

Em sua planilha irá chamar a função dentro da célula assim: =ola_mundo()

=ola_mundo()

Exemplo de função com URL externa

Exemplo de função personalizada que envia dados para a URL de webhook de uma aplicação rodando chatGPT que retorna o texto para a célula:

function WGPT(input, typeGPT) {
  var url = 'https://seu-webhook.com.br/v1/seu-endpoint';
  
  var data = { text: input };
  if (typeGPT !== undefined) {
    data.typegpt = typeGPT;
  }
  
  var payload = JSON.stringify(data);

  var options = {
    'method': 'post',
    'contentType': 'application/json',
    'payload': payload,
    'muteHttpExceptions': true
  };

  var response = UrlFetchApp.fetch(url, options);
  if (response.getResponseCode() == 200) {
    var content = response.getContentText();
    return content;
  } else {
    return "Erro ao receber resposta";
  }
}

Depois disso, em sua planilha, para executar seu código, basta usar a mesma técnica que usa para funções padrões do google sheet, mas agora vai usar o nome da funções, que nesse exemplo é WGPT, como mostra abaixo:

=WGPT("Crie um texto de bom dia!")

Você pode dar o nome que quiser para sua função, este foi apenas o exemplo que usei, mas você pode criar outras funções e nomear como quiser para ficar mais fácil de usar em sua planilha.