GPT Workspace

Como usar o Google Apps Script agora que o Gemini cria o código

Aprenda a usar o Google Apps Script sem programar. O Gemini no Apps Script já está disponível: planos, configuração, limites e alternativas.

Mathias Gilson
Mathias Gilson
Autor
16 de novembro de 2026
Ultimamente verificado no GPT Workspace em 16 de novembro de 2026

Compartilhar

Como usar o Google Apps Script agora que o Gemini cria o código

Todo Google Sheets, Docs, Slides e Forms tem um editor de código escondido no menu Extensões, e a maioria das pessoas abre uma vez e fecha logo em seguida. Se você nunca aprendeu como usar o Google Apps Script porque isso significava escrever em JavaScript, essa barreira caiu esta semana.

A versão resumida: clique em Extensões, depois em Apps Script, descreva a tarefa no painel lateral do Gemini, revise o código proposto, salve e execute. O Google anunciou a disponibilidade geral desse painel lateral em 16 de novembro de 2026, para planos Business Standard e superiores, e para o Google AI Pro e Ultra.

Este guia mostra como criar o seu primeiro script, prompts para começar, os limites impostos pelo Google e o que fazer em um plano sem o painel. É nessa última parte que o GPT Workspace entra. Ele é uma extensão do Chrome e um complemento do Google Workspace que coloca o ChatGPT, Claude e Gemini dentro do Sheets, Docs, Slides e Gmail.

O que mudou: o Gemini no Apps Script já está disponível para todos

O Apps Script é a camada de automação integrada ao Workspace. De acordo com a visão geral do Apps Script do Google, você escreve JavaScript em um editor no navegador sem precisar instalar nada, e seus scripts são salvos no Drive e executados nos servidores do Google.

O JavaScript sempre foi o maior obstáculo. A publicação do Workspace Updates do Google de 16 de novembro de 2026 remove essa barreira. Com a disponibilidade geral do painel lateral, qualquer pessoa pode “criar, personalizar e solucionar problemas de scripts usando linguagem natural, sem precisar de experiência em programação”.

O painel faz três coisas.

Função O que o Gemini faz Onde acontece
Escrever Transforma um pedido em linguagem natural em um script e adiciona extras, como gatilhos baseados em tempo, se solicitado Painel lateral do Gemini
Revisar Mostra cada alteração proposta como um bloco que você pode aceitar ou rejeitar antes de salvar Editor de código
Corrigir Explica um erro de execução em linguagem natural e sugere uma atualização pronta para aplicar Registro de execução

Quem tem acesso

  • Planos: Business Standard e Plus, Enterprise Standard e Plus, o complemento AI Expanded Access, Google AI Pro for Education, além das contas pessoais Google AI Pro e Ultra.
  • Fora da lista: Business Starter e contas pessoais gratuitas.
  • Prazos: um lançamento gradual em domínios de Lançamento Rápido e Lançamento Agendado que começou em 12 de novembro de 2026, podendo levar até 15 dias para o painel aparecer.
  • Permissões: os scripts rodam “com as permissões existentes do usuário e o consentimento padrão do OAuth”, ou seja, um script só pode acessar o que a sua conta já tem permissão para acessar.
  • Administradores: o Google afirma que o painel “respeita as configurações de serviço atuais do Apps Script” e os controles de acesso à IA generativa no Admin Console.

O guia do desenvolvedor ainda está desatualizado

O guia do desenvolvedor do Google para o painel do Gemini foi atualizado pela última vez em 3 de setembro de 2026 e, em 16 de novembro, ainda exibia um aviso de versão beta. O texto diz que você deve aceitar ou rejeitar uma proposta por completo e que o Gemini funciona apenas no arquivo ativo.

A publicação de lançamento descreve uma revisão bloco a bloco e um Gemini que “entende os arquivos em todo o seu projeto aberto do Apps Script”. Se o seu editor oferecer apenas as opções de Aceitar tudo e Rejeitar tudo, você ainda pode estar na versão anterior, já que a atualização pode levar 15 dias.

Como usar o Google Apps Script com o Gemini: o seu primeiro script

O exemplo abaixo vem da demonstração de lançamento do Google: uma função personalizada que calcula a comissão de vendas em uma planilha.

  1. Abra o editor. No Google Sheets, clique em Extensões e depois em Apps Script. Para um script que não esteja vinculado a um arquivo específico, acesse script.new.
Menu Extensões do Google Sheets aberto com a opção Apps Script, o primeiro passo de como usar o Google Apps Script
Captura de tela do Google Sheets: o menu Extensões com a opção Apps Script, da demonstração de lançamento do Google em novembro de 2026. Fonte: Google Workspace Updates.
  1. Abra o painel do Gemini. O Google diz que ele “abre automaticamente em novos scripts”. Em um projeto já existente, clique no ícone de brilho Perguntar ao Gemini no canto superior direito do editor.
  2. Descreva a tarefa. Informe a entrada, a regra e a saída. O prompt da demonstração do Google diz: “Crie uma função personalizada COMMISSION(amount, region). Taxas: NA 8%, EMEA 7%, APAC 7.5%, LATAM 9%. Adicione 1% para negócios de US$ 100 mil ou mais.”
Painel lateral do Gemini no editor do Apps Script com três prompts iniciais e um pedido digitado para uma função personalizada COMMISSION
Captura de tela do Google Apps Script: o painel lateral do Gemini em um novo script, com três prompts iniciais acima da caixa Perguntar ao Gemini e o pedido de demonstração sendo digitado. Fonte: Google Workspace Updates.
  1. Revise a proposta. O novo código aparece no editor com as adições em verde e as remoções em vermelho. Clique em Aceitar ou Rejeitar em um bloco, ou use Aceitar tudo e Rejeitar tudo no painel lateral.
Editor do Apps Script visualizando o código sugerido pelo Gemini com botões de Aceitar e Rejeitar no bloco e Aceitar tudo no painel lateral
Captura de tela do Google Apps Script: a proposta do Gemini no editor. Os botões Aceitar e Rejeitar ficam no bloco, e Aceitar tudo e Rejeitar tudo ficam no painel lateral. Fonte: Google Workspace Updates.
  1. Salve o projeto. Clique no ícone Salvar projeto no Drive na barra de ferramentas do editor.
  2. Use a função. De volta à planilha, digite =COMMISSION(E2, A2) como faria com qualquer função nativa. O Sheets mostra a descrição que o Gemini escreveu como texto de ajuda enquanto você digita.

Funções personalizadas são a forma mais tranquila de começar o seu primeiro projeto. O guia de funções personalizadas do Google diz que elas “nunca pedem aos usuários para autorizar o acesso a dados pessoais”.

Um script que lê o Gmail ou envia e-mails é diferente. A primeira execução abre um aviso de permissão do Google, e o guia do desenvolvedor orienta a “revisar as permissões solicitadas antes de clicar em Permitir”.

Exemplos no Google Apps Script: prompts para você começar

Um prompt funciona bem quando especifica três coisas: quando o script deve rodar, quais dados ele vai ler e para onde vai o resultado. Estes exemplos fazem exatamente isso.

Tarefa Prompt Fonte
Função personalizada “Crie uma função personalizada CONSOLIDATE_DATA que agrupe colunas por ID, calcule o valor máximo e liste os status exclusivos.” Guia do desenvolvedor do Google
Do Gmail para o Tasks “Escreva um script que pesquise na minha caixa de entrada do Gmail por e-mails não lidos com ‘URGENTE’ no assunto nos últimos 30 dias e os adicione no meu Google Tasks.” Guia do desenvolvedor do Google
Do Sheets para o Docs “Crie um menu personalizado no Google Sheets chamado ‘Exportar para o Docs’ que exporte o conteúdo da tabela para um novo Google Docs e envie o caminho para o usuário.” Guia do desenvolvedor do Google
Relatório semanal “Toda segunda-feira às 8h, envie-me por e-mail as linhas na aba Vendas onde o Status é Atrasado.” Nosso próprio exemplo

Programe a execução de um script

Você não precisa saber o que é um gatilho (trigger). A publicação de lançamento diz que você pode “continuar conversando para adicionar recursos, como gatilhos automáticos baseados em tempo”.

O guia de gatilhos instaláveis do Google diz que um gatilho temporal pode ser executado “com a frequência de um minuto ou até uma vez por mês”.

Dois detalhes costumam surpreender as pessoas. Um gatilho recorrente programado para as 9h é disparado em um horário que o Apps Script escolhe entre 9h e 10h, e um gatilho sempre é executado usando a conta da pessoa que o criou.

Altere um script que você já tem

Para fazer edições, indique o código pelo nome. O guia do desenvolvedor explica da seguinte forma: “Faça referência explícita a funções ou variáveis existentes no seu arquivo de trabalho”.

Quando um script falha: como corrigir erros e os limites que você precisa conhecer

Scripts falham, inclusive os que o Gemini escreve. Quando uma execução para devido a um erro, o registro de execução mostra um botão Corrigir erros.

  1. Execute a função e espere a linha vermelha de erro aparecer no registro de execução.
  2. Clique em Corrigir erros. O Gemini lê o erro e o código ao redor dele.
  3. Leia a explicação e, em seguida, aceite ou rejeite a alteração proposta.
  4. Salve e execute novamente para confirmar que o erro desapareceu.
Registro de execução do Apps Script mostrando um TypeError e o botão Corrigir erros que pede ao Gemini para diagnosticá-lo
Captura de tela do Google Apps Script: uma execução com falha no registro de execução. O botão Corrigir erros fica no canto superior direito do registro, acima da linha vermelha de erro. Fonte: Google Workspace Updates.

Na demonstração do Google, um script do Gmail para o Calendar falhou com a mensagem “TypeError: thread.getSubject is not a function”. O Gemini respondeu que uma thread (conversa) do Gmail não possui esse método, então a correção passou a ler o assunto da mensagem mais recente.

Alguns problemas não geram nenhum erro. Nesses casos, o guia do desenvolvedor sugere um prompt simples, como “O script não apresenta erro, mas a saída está incorreta”.

As cotas que interrompem um script

O Gemini escreve o script, mas os servidores do Google ainda limitam o tempo e a frequência de execução. Os números abaixo vêm da página de cotas do Apps Script do Google.

Limite Conta pessoal (gmail.com) Conta do Google Workspace
Tempo de execução do script 6 minutos por execução 6 minutos por execução
Tempo de execução da função personalizada 30 segundos por execução 30 segundos por execução
Gatilhos 20 por usuário por script 20 por usuário por script
Tempo total de execução de gatilhos 90 minutos por dia 6 horas por dia
Destinatários de e-mail 100 por dia 1.500 por dia

Quando um script ultrapassa um limite, ele gera uma exceção e para. O Google acrescenta que as cotas podem mudar a qualquer momento sem aviso prévio.

As funções personalizadas têm mais uma regra. Segundo o guia do Google, uma função personalizada “não pode afetar outras células além daquelas para as quais retorna um valor”. Portanto, peça ao Gemini um item de menu personalizado quando precisar reescrever um intervalo inteiro.

Limites do próprio painel

O guia do desenvolvedor lista mais alguns limites, e vale a pena verificar cada um deles no seu próprio editor.

  • Idioma: o inglês é o único idioma suportado.
  • Contas: o painel pode não carregar quando várias Contas do Google estiverem conectadas na mesma sessão do navegador.
  • Acesso: o Gemini só funciona em projetos de script que você possui ou pode editar.
  • Links: o Gemini “ocasionalmente omite URLs do código gerado”, então cole a URL exata diretamente no seu prompt.
Fique de olhoO próprio painel traz o aviso "O Gemini no Workspace pode cometer erros". Antes de aceitar um script que exclua, envie ou compartilhe qualquer coisa, leia essa parte do código e teste em uma cópia do arquivo.

Não tem um plano com o Gemini? Veja onde o GPT Workspace se encaixa

O Apps Script em si não é restrito. A tabela de cotas do Google cobre contas pessoais gmail.com e contas do Workspace, o que significa que o editor está disponível em planos bem inferiores ao Business Standard.

O que falta nessas contas é o assistente. É essa lacuna que o GPT Workspace preenche, funcionando direto da planilha em vez do editor.

  1. Abra a barra lateral do GPT Workspace na sua planilha e escolha um modelo: ChatGPT, Claude ou Gemini.
  2. Peça o script da mesma forma que pediria ao Gemini, informando a programação, os dados e a saída.
  3. Cole o código no editor em Extensões, depois em Apps Script, e salve.
  4. Se a execução falhar, cole a linha de erro de volta na barra lateral e peça uma correção.

Como usar o Google Apps Script sem um plano Gemini: um prompt do GPT Workspace no Sheets pedindo um script que envia por e-mail as linhas atrasadas toda segunda-feira às 8h

Ilustração, não uma captura de tela: um pedido que você poderia digitar na barra lateral do GPT Workspace no Sheets. Ele informa a programação, os dados e a saída, as mesmas três partes que um prompt do Gemini precisa.

GPT Workspace logo Experimente o GPT Workspace

Use o ChatGPT, Claude e Gemini diretamente no Google Docs, Sheets, Slides, Gmail e Drive. Sem precisar trocar de aba.

Comece grátis

Muitas vezes, a melhor solução é não usar nenhum script.

O que você quer Caminho mais curto
Uma tarefa recorrente em um plano qualificado do Google Gemini no Apps Script
A mesma tarefa no Business Starter ou no Gmail gratuito O GPT Workspace escreve o script e você o cola no Apps Script
IA em cada linha: categorizar, traduzir, pesquisar Fórmulas do GPT Workspace como =GPT, =GPT_CLASSIFY, =GPT_TRANSLATE e =GPT_WEB
Uma limpeza rápida ou resumo pontual Um prompt na barra lateral do GPT Workspace sobre o intervalo selecionado

Uma fórmula é melhor que um script quando o trabalho exige uma análise por linha. Nosso guia sobre como usar IA no Google Sheets aborda a barra lateral, e o tutorial do =GPT_CLASSIFY mostra como classificar dados no Google Sheets com rótulos fixos.

Onde o Gemini ganha: ele vive no editor, propõe alterações como um comparativo revisável e corrige erros direto do registro. Se o seu plano o incluir, use-o para qualquer coisa que dependa de um gatilho.

Onde o GPT Workspace ganha: não exige um plano com o Gemini, permite escolher o modelo e suas fórmulas dispensam totalmente o editor. Ele possui um plano gratuito com limites de uso, e os planos pagos aumentam esses limites.

Não sabe para qual modelo pedir um script? Nosso guia sobre quando usar o Claude e quando usar o ChatGPT compara os dois em tarefas reais do Workspace.

Como usar o Google Apps Script com o GPT Workspace: qualquer conta do Google, ChatGPT, Claude ou Gemini, cole o script no Apps Script ou pule essa etapa com fórmulas =GPT

Ilustração, não uma captura de tela: os quatro pontos desta seção em uma única lista. Em uma conta de trabalho ou de estudante, o administrador decide quais complementos você pode instalar.

Perguntas Frequentes

O Google Apps Script é gratuito?
Você não precisa de um plano pago para escrever e executar scripts. A tabela de cotas do Google abrange tanto contas pessoais gmail.com quanto contas do Workspace, cada uma com limites diários. O painel lateral do Gemini é a parte que exige um plano qualificado, como o Business Standard ou o Google AI Pro.
Preciso saber JavaScript para usar o Google Apps Script com o Gemini?
Não. O Google descreve o painel como algo que não exige experiência em programação. Você descreve a tarefa e o Gemini escreve o código. Ainda assim, leia o que um script faz antes de aceitá-lo, pois o painel avisa que o Gemini pode cometer erros.
Por que não consigo ver o painel lateral do Gemini no Apps Script?
Verifique três coisas. O seu plano precisa estar na lista do Google, o administrador precisa permitir os recursos do Apps Script e do Gemini, e o lançamento que começou em 12 de novembro de 2026 pode levar até 15 dias. Se você estiver conectado a várias Contas do Google, tente usar um perfil de navegador com apenas uma.
O GPT Workspace pode escrever o Apps Script para mim?
Sim. Faça o pedido na barra lateral do GPT Workspace no Sheets e, em seguida, cole o código no editor em Extensões, Apps Script. O GPT Workspace não roda dentro do editor de scripts, então você mesmo revisa e cola o código.

Conclusão

Aprender como usar o Google Apps Script costumava começar com um curso de JavaScript. Agora, começa com uma frase: abra Extensões, clique em Apps Script, diga ao Gemini o que você quer, revise cada bloco e fique de olho nas cotas.

Se o seu plano não inclui o painel, ou se o trabalho é realmente uma resposta de IA por linha, o GPT Workspace resolve os dois problemas de dentro da sua planilha. Instale-o, peça o seu primeiro script ou fórmula e veja qual caminho é mais curto.

GRÁTIS PARA INSTALAR

ChatGPT em todos os aplicativos do Google, de graça

Junte-se a 7 milhões de usuários que já usam o GPT Workspace para impulsionar sua produtividade.

Ao instalar o GPT Workspace, você concorda com os
Termos de Serviço ePolítica de Privacidade