Aller au contenu
Cercle IA Tech · Intégration Un site du réseau Cercle IA Tech

Guide

API Google Sheets : quotas et erreur 429

Limites de l'API Google Sheets pour un assistant IA : 300 requêtes par minute et par projet, 60 par utilisateur, erreur 429, backoff, 180 secondes.

Mis à jour le

Réduire le nombre d'appels
  1. Lire une plage large en une requête plutôt que cellule par cellule.
  2. Garder en mémoire côté serveur ce que l'assistant vient de lire, pour ne pas relire la feuille à chaque message d'un même échange.
  3. Grouper les écritures au lieu de passer une requête par ligne.
  4. Faire passer les appels par une file d'attente qui lisse le débit, comme dans l'architecture type ; voir aussi Cloudflare Queues et les réessais.

Brancher un assistant IA sur une feuille Google Sheets par l'API est courant : suivi de commandes, liste de prospects, tableau de stocks. Le piège, c'est le quota. Un assistant qui lit la feuille à chaque question, ou qui écrit ligne par ligne, atteint vite la limite. Les chiffres ci-dessous viennent de la page des limites de l'API Google Sheets, lue le 16/11/2026.

La documentation d’ALMA pour les intégrations API permet de préparer le lien avec votre assistant. Regroupez les lectures nécessaires dans votre application et définissez quels résultats peuvent être réutilisés avant chaque nouvelle demande au tableur.

Les quotas

Type de requête Par minute et par projet Par minute, par utilisateur et par projet
Lecture 300 60
Écriture 300 60

Deux plafonds jouent ensemble. Si votre assistant passe par un seul compte utilisateur, c'est la limite de 60 par minute qui compte, pas celle des 300 du projet. Si plusieurs personnes passent par le même projet Google Cloud, c'est le total de 300 par minute qui est partagé entre elles.

Ce qui arrive au dépassement

L'API renvoie une réponse HTTP 429 (« Too many requests »). La conséquence pour l'assistant : la requête n'a pas été exécutée, et il faut la rejouer. Un assistant qui ne gère pas ce code répond à l'utilisateur par une erreur ou, pire, par une réponse construite sans les données.

Réessayer correctement

Google demande un délai exponentiel (exponential backoff). La version décrite est « tronquée » : l'attente entre deux essais augmente jusqu'à un maximum, généralement 32 ou 64 secondes, et on ajoute jusqu'à 1 000 millisecondes d'aléa (jitter) pour éviter que plusieurs clients repartent en même temps. Réessayer immédiatement aggrave le problème, parce que chaque requête compte dans le quota. Les mêmes principes de délai figurent dans la page mise en production, pour d'autres éditeurs.

Deux autres limites qui comptent

  • Délai d'une requête : si Sheets traite une requête plus de 180 secondes, elle échoue avec une erreur de délai dépassé.
  • Taille : Google recommande une charge utile de 2 Mo au plus pour accélérer les requêtes. Il n'y a pas de limite stricte par requête, mais d'autres composants du traitement peuvent en imposer.

Réduire le nombre d'appels

La page de limites insiste sur le comptage des requêtes, pas sur le nombre de cellules. Quelques habitudes en découlent, comme conséquence logique et non comme règle de Google :

  1. Lire une plage large en une requête plutôt que cellule par cellule.
  2. Garder en mémoire côté serveur ce que l'assistant vient de lire, pour ne pas relire la feuille à chaque message d'un même échange.
  3. Grouper les écritures au lieu de passer une requête par ligne.
  4. Faire passer les appels par une file d'attente qui lisse le débit, comme dans l'architecture type ; voir aussi Cloudflare Queues et les réessais.

Mesurer un parcours utilisateur

Comptez les appels déclenchés par une question complète, y compris les reprises et les lectures de métadonnées. Rejouez ensuite ce parcours avec plusieurs utilisateurs simultanés sur un environnement d’essai. Votre mesure doit montrer quel plafond est atteint en premier et combien de temps l’utilisateur attend. Prévoyez un message explicite lorsque les données ne peuvent pas être rafraîchies, avec leur date si une ancienne copie est utilisée.

Quand l'API n'est pas la bonne porte

Si l'assistant doit surtout analyser une feuille, sans l'écrire, exporter les données à intervalle régulier et les lui fournir évite de consommer le quota à chaque question. Si les données sont des commandes ou des clients qui grossissent, un CRM ou un ERP est un meilleur point de départ : voir IA et CRM et IA et ERP.

Le même mécanisme de limite de débit existe côté modèle d'IA, avec ses propres valeurs : Cercle IA Tech · API, erreur 429.

Questions fréquentes

Quelle est la limite de lectures de l'API Google Sheets ?

300 requêtes de lecture par minute et par projet, et 60 par minute et par utilisateur et par projet.

Que se passe-t-il quand on dépasse le quota ?

L'API renvoie le code HTTP 429, « Too many requests ».

Comment réessayer après un 429 ?

Avec un délai exponentiel tronqué : l'attente augmente à chaque essai jusqu'à un maximum, en général 32 ou 64 secondes, avec jusqu'à 1 000 ms d'aléa ajouté.

Sources

Pages consultées pour écrire cet article :

  1. https://alma.iarche.fr/fr/api-docs
  2. https://developers.google.com/workspace/sheets/api/limits

À lire aussi