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 vai gerar uma exceção e a execução será interrompida.
Importante: alguns recursos têm cotas adicionais do produto do Google a que estão associados. O uso do serviço do Apps Script de um produto conta para todas as reservas de cota associadas. Um recurso fica 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 pessoais (como gmail.com) ou da edição sem custo financeiro do G Suite (descontinuada) 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 (legada) |
Contas do Google Workspace |
|---|---|---|
| Eventos da agenda criados | 5.000 / dia | 10.000 / dia |
| Contatos criados | 1.000 / dia | 2.000 por dia |
| Documentos criados | 250 por dia | 1.500 / dia |
| Arquivos convertidos | 2.000 por dia | 4.000 / dia |
| Destinatários de e-mail por dia (por exemplo, com MailApp) | 100* / dia | 1.500* / dia |
| Destinatários de e-mail por dia dentro do domínio (por exemplo, com MailApp) | 100* / dia | 2.000 por dia |
| Leitura/gravação de e-mails (exceto envio) | 20.000 / dia | 50.000 / dia |
| Ler nos grupos | 2.000 por dia | 10.000 / dia |
| Conexão JDBC | 10.000 / dia | 50.000 / dia |
| Falha na conexão JDBC | 100 por dia | 500 por dia |
| Apresentações criadas | 250 por dia | 1.500 / dia |
| Leitura/gravação de propriedades | 50.000 / dia | 500.000 / dia |
| Slides criados | 250 por dia | 1.500 / dia |
| Planilhas criadas | 250 por dia | 3.200 por dia |
| Tempo de execução total dos acionadores | 90 min / dia | 6 h / 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 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 por dia | 50 por dia |
Limitações atuais
Use os limites abaixo para testar seus scripts. Todos os limites estão sujeitos 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 (legada) |
Contas do Google Workspace |
|---|---|---|
| Tempo de execução do script | 6 min / execução | 6 min / execução |
| Tempo de execução da função personalizada | 30 segundos / execução | 30 segundos / execução |
| Tempo 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-mails | 250 / msg | 250 / msg |
| Tamanho do corpo do e-mail | 200 KB / msg | 400 KB / msg |
| Destinatários de e-mail por mensagem | 50 / msg | 50 / msg |
| Tamanho total dos anexos do e-mail | 25 MB / msg | 25 MB / 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 de busca de URL | 50 MB / chamada | 50 MB / chamada |
| Cabeçalhos de URLFetch | 100 / chamada | 100 / chamada |
| Tamanho do cabeçalho de busca de URL | 8 KB / chamada | 8 KB / chamada |
| Tamanho da postagem de URLFetch | 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 vai gerar 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 especificado 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 muitas vezes em um curto período.Service using too much computer time for one day.Isso indica que o script excedeu o tempo total de execução permitido para um dia. Isso acontece com mais frequência em scripts executados por um gatilho, que tem 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 período curto. Isso geralmente acontece com funções personalizadas que são chamadas repetidamente em uma única planilha. Para evitar esse erro, codifique suas 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 há muitos scripts sendo executados ao mesmo tempo, mas não necessariamente o mesmo script. Assim como na exceção acima, isso ocorre mais comumente em funções personalizadas que são chamadas repetidamente em uma única planilha.