Les services Google Apps Script sont soumis à des quotas quotidiens et à des limites concernant certaines fonctionnalités. Si vous dépassez un quota ou une limite, votre script génère une exception et l'exécution s'arrête.
Certaines fonctionnalités sont soumises à des quotas supplémentaires de leur produit Google associé. L'utilisation du service Apps Script d'un produit est comptabilisée dans toutes les réserves de quotas associées. Une fonctionnalité devient indisponible si vous atteignez l'un des quotas associés.
Quotas actuels
Les quotas sont définis à différents niveaux pour les utilisateurs de comptes personnels (tels que gmail.com) et de comptes Google Workspace. Les quotas sont par utilisateur et sont réinitialisés 24 heures après la première requête.
Utilisez les quotas suivants pour tester vos scripts. Ils sont susceptibles d'être supprimés, réduits ou modifiés à tout moment et sans préavis.
| Fonctionnalité | Comptes personnels (par exemple, gmail.com) | Comptes Google Workspace |
|---|---|---|
| Événements d'agenda créés | 5 000 / jour | 10 000 / jour |
| Contacts créés | 1 000 / jour | 2 000 / jour |
| Documents créés | 250 / jour | 1 500 / jour |
| Fichiers convertis | 2 000 / jour | 4 000 / jour |
| Destinataires d'e-mails par jour (par exemple, avec MailApp) | 100* / jour | 1 500* / jour |
| Destinataires d'e-mails par jour au sein du domaine (par exemple, avec MailApp) | 100* / jour | 2 000 / jour |
| Lecture/écriture d'e-mails (hors envoi) | 20 000 / jour | 50 000 / jour |
| Groupes lus | 2 000 / jour | 10 000 / jour |
| Connexions JDBC | 10 000 / jour | 50 000 / jour |
| Échecs de connexion JDBC | 100 / jour | 500 / jour |
| Présentations créées | 250 / jour | 1 500 / jour |
| Lecture/écriture de propriétés | 50 000 / jour | 500 000 / jour |
| Diapositives créées | 250 / jour | 1 500 / jour |
| Feuilles de calcul créées | 250 / jour | 3 200 / jour |
| Temps d'exécution total des déclencheurs | 90 min / jour | 6 h / jour |
| Appels de récupération d'URL | 20 000 / jour | 100 000 / jour |
| Rendu de carte statique | 1 000 / jour | 10 000 / jour |
| Requête d'itinéraire Google Maps | 1 000 / jour | 10 000 / jour |
| Appels de géocodage Google Maps | 1 000 / jour | 10 000 / jour |
| Appels de traduction | 5 000 / jour | 20 000 / jour |
| Requête d'échantillons d'altitude Google Maps | 1 000 / jour | 10 000 / jour |
| Projets Apps Script | 50 / jour | 50 / jour |
Des limites supplémentaires s'appliquent aux comptes en période d'essai. Après avoir fait passer votre compte d'un essai sans frais à un abonnement payant, les limites de votre compte sont automatiquement augmentées lorsque les deux conditions suivantes sont remplies :
- Le paiement total pour votre domaine a atteint au moins 100 USD (ou l'équivalent dans votre devise).
- Au moins 60 jours se sont écoulés depuis que ce seuil de paiement a été atteint.
Limites actuelles
Utilisez les limites suivantes pour tester vos scripts. Elles sont susceptibles d'être supprimées, réduites ou modifiées à tout moment et sans préavis.
| Fonctionnalité | Comptes personnels (par exemple, gmail.com) | Comptes Google Workspace |
|---|---|---|
| Durée d'exécution du script | 6 min / exécution | 6 min / exécution |
| Durée d'exécution de la fonction personnalisée | 30 s / exécution | 30 s / exécution |
| Durée d'exécution du module complémentaire Google Workspace | 30 s / exécution | 30 s* / exécution |
| Exécutions simultanées par utilisateur | 30 / utilisateur | 30 / utilisateur |
| Exécutions simultanées par script | 1 000 | 1 000 |
| Pièces jointes | 250 / message | 250 / message |
| Taille du corps de l'e-mail | 200 Ko / message | 400 Ko / message |
| Destinataires d'e-mails par message | 50 / message | 50 / message |
| Taille totale des pièces jointes | 25 Mo / message | 25 Mo / message |
| Taille de la valeur des propriétés | 9 Ko / valeur | 9 Ko / valeur |
| Stockage total des propriétés | 500 Ko / magasin de propriétés | 500 Ko / magasin de propriétés |
| Déclencheurs | 20 / utilisateur / script | 20 / utilisateur / script |
| Taille de la réponse URL Fetch | 50 Mo / appel | 50 Mo / appel |
| En-têtes URL Fetch | 100 / appel | 100 / appel |
| Taille d'en-tête URL Fetch | 8 Ko / appel | 8 Ko / appel |
| Taille POST URL Fetch | 50 Mo / appel | 50 Mo / appel |
| Longueur d'URL URL Fetch | 2 Ko / appel | 2 Ko / appel |
| Versions | 200 / script | 200 / script |
Surveiller l'utilisation du quota
Pour surveiller la consommation de quotas et l'état d'exécution de votre script, utilisez les méthodes suivantes :
- Quota d'e-mails : utilisez
MailApp.getRemainingDailyQuota()pour vérifier le nombre de destinataires d'e-mails restants auxquels vous pouvez envoyer des messages pour le reste de la journée. - Surveillance de l'exécution : utilisez le
tableau de bord Apps Script pour afficher l'
historique d'exécution et l'état de votre script. La page Mes exécutions affiche l'état (par exemple,
Completed,FailedouRunning) de chaque exécution de script. Vous pouvez surveiller le nombre d'exécutions simultanées en filtrant les exécutions dont l'état estRunning. - Console Google Cloud : si votre projet Apps Script utilise un projet Google Cloud standard, vous pouvez surveiller les quotas spécifiques aux services et l'utilisation des API dans la console Google Cloud.
Messages d'exception
Si un script atteint un quota ou une limite, il génère une exception avec un message semblable à celui-ci :
Limit exceeded: Email Attachments Per Message.Cela indique que le script a dépassé l'un des quotas ou l'une des limites listés dans les sections Quotas actuels ou Limites actuelles.Service invoked too many times: Calendar.(Trop d'appels effectués ce jour pour ce service : Agenda.) Cela indique que le script a appelé le service donné trop de fois en une journée.Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls.Cela indique que le script a appelé le service donné trop de fois en peu de temps.Service using too much computer time for one day.(Le service utilise trop de temps de calcul pour une journée.) Cela indique que le script a dépassé le temps d'exécution total autorisé pour une journée. Cela se produit le plus souvent pour les scripts qui s'exécutent sur un déclencheur, dont la limite quotidienne est inférieure à celle des scripts exécutés manuellement.Script invoked too many times per second for this Google user account.(Le script a été appelé trop de fois par seconde pour ce compte utilisateur Google.) Cela indique que le script a commencé à s'exécuter trop de fois en peu de temps. Cela se produit le plus souvent pour les fonctions personnalisées qui sont appelées de manière répétée dans une seule feuille de calcul. Pour éviter cette erreur, codez vos fonctions personnalisées de sorte qu'elles ne doivent être appelées qu'une seule fois par plage de données, comme expliqué dans le guide sur les fonctions personnalisées.There are too many scripts running simultaneously for this Google user account.(Trop de scripts sont exécutés simultanément pour ce compte utilisateur Google.) Cela indique que vous avez trop de scripts en cours d'exécution en même temps, mais pas nécessairement le même script. Comme l'exception précédente, cela se produit le plus souvent pour les fonctions personnalisées qui sont appelées de manière répétée dans une seule feuille de calcul.
Articles associés
- Restrictions concernant les déclencheurs de fichier manifeste.
- Restrictions concernant les déclencheurs de modules complémentaires d'éditeurs.