Les services Google Apps Script sont soumis à des quotas et des limites quotidiennes pour 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 disposent de quotas supplémentaires provenant du produit Google associé. L'utilisation du service Apps Script d'un produit est comptabilisée dans toutes les réserves de quota 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 demande.
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 |
| Propriétés en lecture/écriture | 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 Google Map Geocode | 1 000 / jour | 10 000 / jour |
| Traduire les appels | 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 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. Toutes les limites sont susceptibles d'être supprimées, réduites ou modifiées à tout moment et sans préavis.
| Fonctionnalité | Comptes personnels (gmail.com, par exemple) | Comptes Google Workspace |
|---|---|---|
| Exécution du script | 6 min / exécution | 6 min / exécution |
| Environnement d'exécution des fonctions personnalisées | 30 s / exécution | 30 s / exécution |
| Environnement d'exécution des modules complémentaires 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 / msg | 250 / msg |
| Taille du corps de l'e-mail | 200 Ko / message | 400 Ko / message |
| Nombre de destinataires 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 / val | 9 ko / val |
| 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 de l'en-tête URL Fetch | 8 ko / appel | 8 ko / appel |
| Taille POST URLFetch | 50 Mo / appel | 50 Mo / appel |
| Longueur d'URL URLFetch | 2 Ko / appel | 2 Ko / appel |
| Versions | 200 / script | 200 / script |
Surveiller l'utilisation du quota
Pour surveiller la consommation de quota 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 des exécutions : utilisez le tableau de bord Apps Script pour afficher l'historique des exécutions 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 est défini surRunning. - 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 à ce qui suit :
Limit exceeded: Email Attachments Per Message.: 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.: 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 sur une courte période.Service using too much computer time for one day.: 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, qui ont une limite quotidienne inférieure à celle des scripts exécutés manuellement.Script invoked too many times per second for this Google user account.Cela indique que le script a commencé à s'exécuter trop de fois sur une courte période. Cela se produit le plus souvent pour les fonctions personnalisées qui sont appelées à plusieurs reprises dans une même feuille de calcul. Pour éviter cette erreur, codez vos fonctions personnalisées de sorte qu'elles n'aient besoin d'ê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.Cela signifie que trop de scripts sont exécutés en même temps, même s'il ne s'agit pas forcément du même script. Comme l'exception précédente, celle-ci se produit le plus souvent pour les fonctions personnalisées qui sont appelées à plusieurs reprises dans une même feuille de calcul.
Articles associés
- Restrictions pour les déclencheurs de fichier manifeste.
- Restrictions concernant les déclencheurs des modules complémentaires d'éditeurs