Os serviços do Google 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.
Alguns recursos têm cotas adicionais do produto do Google associado a eles. 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 de consumidor (como gmail.com) e contas 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 a seguir para ajudar a testar seus scripts. Todas as cotas estão sujeitas a eliminação, redução ou mudança a qualquer momento, sem aviso prévio.
| Recurso | Contas de consumidor (por exemplo, gmail.com) | 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 (por exemplo, com MailApp) | 100* / dia | 1.500* / dia |
| Destinatários de e-mail por dia no domínio (por exemplo, com MailApp) | 100* / dia | 2.000 / dia |
| Leitura/gravação de e-mail (excluindo o 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 min / dia | 6 horas / dia |
| Chamadas de busca de URL | 20.000 / dia | 100.000 / dia |
| Renderização de mapas estáticos | 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 |
| Chamadas de tradução | 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 |
Limites adicionais são aplicados a contas de teste. Depois que você converter a conta de teste sem custo em uma assinatura, os limites da conta vão aumentar automaticamente se:
- seu domínio tiver pago de forma cumulativa pelo menos USD 100 (ou o equivalente);
- tiverem passado pelo menos 60 dias após você atingir esse limite mínimo de pagamento.
Limitações atuais
Use os limites a seguir para ajudar a 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 | Contas de consumidor (por exemplo, gmail.com) | 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 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-mails | 250 / mensagem | 250 / mensagem |
| Tamanho do corpo do e-mail | 200 KB / mensagem | 400 KB / mensagem |
| Destinatários de e-mail por mensagem | 50 / mensagem | 50 / mensagem |
| Tamanho total dos anexos do e-mail | 25 MB / mensagem | 25 MB / mensagem |
| Tamanho do valor das propriedades | 9 KB / valor | 9 KB / valor |
| Armazenamento total de propriedades | 500 kB / armazenamento de propriedades | 500 kB / armazenamento 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 busca de URL | 100 / chamada | 100 / chamada |
| Tamanho de cabeçalho de busca de URL | 8 KB / chamada | 8 KB / chamada |
| Tamanho da postagem 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 |
Monitorar o uso de cotas
Para monitorar o consumo de cotas e a integridade da execução do script, use os métodos a seguir:
- Cota de e-mail: use
MailApp.getRemainingDailyQuota()para verificar o número de destinatários de e-mail restantes que você pode enviar pelo resto do dia. - Monitoramento de execução: use o
painel do Apps Script para conferir o
histórico de execução e a integridade do script. A página Minhas execuções mostra o status (por exemplo,
Completed,FailedouRunning) de cada execução de script. Você pode monitorar o número de execuções simultâneas filtrando as execuções com um Status deRunning. - Console do Google Cloud: se o projeto do Apps Script usar um projeto padrão do Google Cloud, você poderá monitorar as cotas específicas do serviço e o uso da API no console do Google Cloud.
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 nas seções Cotas atuais ou Limitações atuais.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 fornecido 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 ocorre com mais frequência 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 com mais frequência em 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 você tem muitos scripts em execução ao mesmo tempo, embora não necessariamente o mesmo script. Como a exceção anterior, isso ocorre com mais frequência em funções personalizadas que são chamadas repetidamente em uma única planilha.