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, o script gerará uma exceção e a execução será interrompida.
Importante: alguns recursos têm cotas extras do produto do Google a 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 fica indisponível quando você atinge uma das cotas associadas.
Cotas atuais
As cotas são definidas em níveis diferentes para usuários de contas pessoais (como o gmail.com) ou da edição sem custo financeiro do G Suite (descontinuada) e contas do Google Workspace. As cotas são por usuário e redefinidas 24 horas após a primeira solicitação.
Use as cotas abaixo para ajudar a 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 | Para consumidor (por exemplo, gmail.com) e a edição sem custo financeiro do G Suite (legada) |
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 |
| Propriedades de leitura/gravação | 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 min / dia | 6h / dia |
| Chamadas de busca de URL | 20.000 / dia | 100.000 / dia |
| Renderização do mapa estático | 1.000 / dia | 10.000 / dia |
| Consulta de rotas no Google Maps | 1.000 / dia | 10.000 / dia |
| Chamadas de geocódigos do Google Maps | 1.000 / dia | 10.000 / dia |
| Traduzir ligações | 5.000 / dia | 20.000 / dia |
| Consulta de exemplos de elevação no 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 | Para consumidor (por exemplo, gmail.com) e a edição sem custo financeiro do G Suite (legada) |
Contas do Google Workspace |
|---|---|---|
| Ambiente de execução do script | 6 min / execução | 6 min / execução |
| Ambiente de execução da 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 segundos / 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 / por msg | 250 / por msg |
| Tamanho do corpo do e-mail | 200 KB / por msg | 400 KB / por msg |
| Destinatários de e-mail por mensagem | 50 / por msg | 50 / por msg |
| Tamanho total dos anexos do e-mail | 25 MB / por msg | 25 MB / por msg |
| Tamanho do valor das propriedades | 9 KB / val | 9 KB / val |
| Armazenamento total das propriedades | 500 KB / loja de propriedades | 500 KB / loja de propriedades |
| 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 / chamada | 100 / chamada |
| Tamanho do cabeçalho de busca de URL | 8 KB / chamada | 8 KB / chamada |
| Tamanho do POST de busca do URL | 50 MB / chamada | 50 MB / chamada |
| Tamanho do URL de busca de URL | 2 KB / chamada | 2 KB / chamada |
| Versions | 200 / script | 200 / script |
Mensagens de exceção
Quando um script atinge uma cota ou limitação, ele gera uma exceção com uma mensagem semelhante à seguinte:
Limit exceeded: Email Attachments Per Message.indica que o script excedeu uma das cotas ou limitações listadas acima.Service invoked too many times: Calendar.: 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.: indica que o script chamou o serviço fornecido muitas vezes em um curto período.Service using too much computer time for one day.indica que o script excedeu o tempo total de execução permitido por um dia. Isso ocorre mais comumente em scripts executados em um acionador, 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 mais comumente para funções personalizadas que são chamadas repetidamente em uma única planilha. Para evitar esse erro, codifique as funções personalizadas para que elas só precisem 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 você tem muitos scripts em execução ao mesmo tempo, mas não necessariamente o mesmo script. Como a exceção acima, isso ocorre com mais frequência para funções personalizadas que são chamadas repetidamente em uma única planilha.