Cotas para Serviços do Google

Os serviços do Apps Script têm cotas diárias e limitações em alguns recursos. Se você exceder uma cota ou limitação, seu script vai gerar uma exceção e a execução será interrompida.

Importante: alguns recursos têm cotas adicionais do produto do Google com que estão associados. O uso do serviço do Apps Script de um produto é contabilizado em todas as reservas de cota associadas. Um recurso ficará indisponível se você atingir qualquer uma das cotas associadas.

Cotas atuais

As cotas são definidas em níveis diferentes para usuários de contas de consumidor (como gmail.com) ou do G Suite sem custo financeiro (descontinuado) e do Google Workspace. As cotas são por usuário e são redefinidas 24 horas após a primeira solicitação.

Use as cotas abaixo para testar seus scripts. Todas as cotas estão sujeitas a eliminação, redução ou alteração a qualquer momento, sem aviso prévio.

Recurso Consumidor (por exemplo, gmail.com) e
edição sem custo financeiro do G Suite
(legado)
Contas do Google Workspace
Eventos da agenda criados 5.000 / dia 10.000 / dia
Contatos criados 1.000 / dia 2.000 / dia
Documentos criados 250 / dia 1.500 / dia
Arquivos convertidos 2.000 / dia 4.000 / dia
Destinatários de e-mail por dia 100* / dia 1.500* / dia
Destinatários de e-mail por dia no domínio 100* / dia 2.000 / dia
Leitura/gravação de e-mail (exceto envio) 20.000 / dia 50.000 / dia
Ler nos grupos 2.000 / dia 10.000 / dia
Conexão JDBC 10.000 / dia 50.000 / dia
Falha na conexão JDBC 100 / dia 500 / dia
Apresentações criadas 250 / dia 1.500 / dia
Leitura/gravação de propriedades 50.000 / dia 500.000 / dia
Slides criados 250 / dia 1.500 / dia
Planilhas criadas 250 / dia 3.200 / dia
Tempo de execução total dos acionadores 90 minutos por dia 6 horas por dia
Chamadas de busca de URL 20.000 / dia 100.000 / dia
Renderização de mapa estático 1.000 / dia 10.000 / dia
Consulta de rotas do Google Maps 1.000 / dia 10.000 / dia
Chamadas de geocodificação do Google Maps 1.000 / dia 10.000 / dia
Traduzir ligações 5.000 / dia 20.000 / dia
Consulta de amostras de elevação do Google Maps 1.000 / dia 10.000 / dia
Projetos do Apps Script 50 / dia 50 / dia

Limitações atuais

Use os limites abaixo para testar seus scripts. Todos os limites estão sujeitos a eliminação, redução ou mudança a qualquer momento, sem aviso prévio.

Recurso Consumidor (por exemplo, gmail.com) e
edição sem custo financeiro do G Suite
(legado)
Contas do Google Workspace
Tempo de execução do script 6 minutos / execução 6 minutos / execução
Ambiente de execução de função personalizada 30 segundos / execução 30 segundos / execução
Ambiente de execução do complemento do Google Workspace 30 segundos / execução 30 s / execução
Execuções simultâneas por usuário 30 / usuário 30 / usuário
Execuções simultâneas por script 1.000 1.000
Anexos de e-mail 250 / msg 250 / msg
Tamanho do corpo do e-mail 200 KB / msg 400 KB / por msg
Destinatários de e-mail por mensagem 50 / msg 50 / msg
Tamanho total dos anexos do e-mail 25 MB / msg 25 MB / por msg
Tamanho do valor das propriedades 9 KB / val 9 KB / val
Armazenamento total das propriedades 500 KB / repositório de propriedades 500 KB / armazenamento de propriedade
Gatilhos 20 / usuário / script 20 / usuário / script
Tamanho da resposta da busca de URL 50 MB / chamada 50 MB / chamada
Cabeçalhos de busca de URL 100 / ligação 100 / ligação
Tamanho do cabeçalho da busca de URL 8 KB / chamada 8 KB / chamada
Tamanho da POST de busca de URL 50 MB / chamada 50 MB / chamada
Comprimento do URL de busca de URL 2 KB / chamada 2 KB / chamada
Versões 200 / script 200 / script

Mensagens de exceção

Se um script atingir uma cota ou limitação, ele lançará uma exceção com uma mensagem semelhante a esta:

  • Limit exceeded: Email Attachments Per Message. Isso indica que o script excedeu uma das cotas ou limitações listadas acima.
  • Service invoked too many times: Calendar. Isso indica que o script chamou o serviço fornecido muitas vezes em um dia.
  • Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls. Isso indica que o script chamou o serviço especificado muitas vezes em um curto período.
  • Service using too much computer time for one day.: indica que o script excedeu o tempo de execução total permitido em um dia. Isso geralmente ocorre com scripts executados em um gatilho, que têm um limite diário menor do que os scripts executados manualmente.
  • Script invoked too many times per second for this Google user account. Isso indica que o script começou a ser executado muitas vezes em um curto período. Isso ocorre com mais frequência em funções personalizadas que são chamadas repetidamente em uma única planilha. Para evitar esse erro, programe suas funções personalizadas para que elas só precisam ser chamadas uma vez por intervalo de dados, conforme explicado no guia de funções personalizadas.
  • There are too many scripts running simultaneously for this Google user account. Isso indica que há muitos scripts sendo executados ao mesmo tempo, mas não necessariamente o mesmo script. Assim como a exceção acima, isso geralmente ocorre com funções personalizadas que são chamadas repetidamente em uma única planilha.