Limites d'utilisation

L'API Google Drive étant un service partagé, nous appliquons des quotas et des limites pour nous assurer qu'elle est utilisée de manière équitable par tous les utilisateurs et pour protéger les performances globales du système Google Workspace.

Les limites sont définies en termes d'unités de quota, une unité de mesure abstraite représentant l'utilisation des ressources Google Drive.

Quotas de l'API Drive

Trois types de quotas sont appliqués :

  • Par minute et par projet : il s'agit du nombre d'unités de quota que votre projet Google Cloud peut utiliser en une minute.

  • Par minute, par utilisateur et par projet : il s'agit du nombre d'unités de quota qu'un utilisateur particulier peut utiliser dans votre projet Cloud. Cette limite vise à vous aider à garantir une répartition équitable de l'utilisation entre vos utilisateurs.

  • Par jour et par projet : il s'agit du nombre maximal d'octets que votre projet Google Cloud peut envoyer sur une période de 24 heures avant que des frais ne s'appliquent.

Le tableau suivant détaille ces limites :

Type de limite d'utilisation Limite
Par minute et par projet 1 000 000 unités de quota
Par minute, par utilisateur et par projet 325 000 unités de quota
Par jour et par projet 1 To

Si vous dépassez un quota, vous recevrez un 403: User rate limit exceeded HTTP code d'état en réponse. Des vérifications supplémentaires de la limite de débit sur le Drive backend peuvent également générer une 429: Rate limit exceeded réponse. Dans ce cas, vous devez utiliser un algorithme d'intervalle exponentiel entre les tentatives et réessayer plus tard.

Seuil de facturation quotidien

Cette limite par jour et par projet définit le nombre maximal d'unités de quota que votre projet Google Cloud peut utiliser sur une période de 24 heures avant que des frais ne s'appliquent.

L'utilisation en dessous de ce seuil n'entraîne pas de frais supplémentaires et votre compte Google Cloud n'est pas facturé. Les détails complets de la facturation seront communiqués plus tard en 2026, au moins 90 jours avant l'entrée en vigueur des modifications.

Vous ne pouvez pas demander d'augmentation de cette limite de seuil quotidien.

Le tableau suivant détaille la limite :

Type de limite de seuil Limite
Par jour et par projet 400 000 000 unités de quota

Pour en savoir plus, consultez Modèle standardisé Google Workspace pour les outils d'agent et les API.

Utilisation du quota par méthode

Le nombre d'unités de quota consommées par requête varie en fonction de la méthode appelée. Le tableau suivant présente l'utilisation des unités de quota par méthode :

Action Unités de quota
Lire des éléments, par exemple files.get 5
Lister des éléments, par exemple files.list 100
Télécharger des éléments, par exemple files.download 200
Modifier des éléments, par exemple files.update 50
Autres actions, par exemple files.generateIds 5

Autres contraintes

Les contraintes suivantes sont appliquées lorsque vous utilisez l'API Drive :

  • Les utilisateurs Google Workspace ne peuvent importer que 750 Go par jour entre leur dossier Mon Drive et tous les Drive partagés. Cette limite s'applique également aux copies.

  • Les utilisateurs qui atteignent la limite de 750 Go ou importent un fichier de plus de 750 Go ne peuvent pas importer ni copier d'autres fichiers avant 24 heures.

  • La taille maximale des fichiers que les utilisateurs peuvent importer est de 5 To. Seul le premier fichier qui dépasse la limite est importé. La taille maximale des fichiers que les utilisateurs peuvent copier est de 750 Go.

  • Les notifications envoyées à l'adresse spécifiée lors de l'ouverture d'un canal de notification ne sont pas prises en compte dans vos limites de quota. Toutefois, les appels aux changes.watch, channels.stop et files.watch méthodes sont pris en compte dans votre quota.

  • Si vous respectez les quotas par minute, le nombre de requêtes que vous pouvez effectuer par jour n'est pas limité.

  • En fonction de votre type de compte Google Workspace, des limites d'espace de stockage Drive supplémentaires s'appliquent .

Résoudre les erreurs de quota basées sur le temps

Pour toutes les erreurs basées sur le temps (maximum de N requêtes par X minutes), nous vous recommandons que votre code intercepte l'exception et utilise un intervalle exponentiel entre les tentatives tronqué pour vous assurer que vos appareils ne génèrent pas de charge excessive.

L'intervalle exponentiel entre les tentatives est une stratégie standard de gestion des erreurs pour les applications réseau. Un algorithme d'intervalle exponentiel entre les tentatives relance les requêtes en augmentant de manière exponentielle le temps d'attente entre les requêtes jusqu'à ce que la durée maximale de l'intervalle soit atteinte. Si les requêtes échouent toujours, il est important que les délais entre les requêtes augmentent au fil du temps jusqu'à ce que la requête réussisse.

Exemple d'algorithme

Un algorithme d'intervalle exponentiel entre les tentatives relance les requêtes de manière exponentielle, en augmentant le temps d'attente entre les tentatives jusqu'à ce que la durée maximale de l'intervalle exponentiel soit atteinte. Exemple :

  1. Vous envoyez une requête à l'API Google Drive.
  2. Si la requête échoue, attendez 1 + random_number_milliseconds et relancez la requête.
  3. Si la requête échoue, attendez 2 + random_number_milliseconds et relancez la requête.
  4. Si la requête échoue, attendez 4 + random_number_milliseconds et relancez la requête.
  5. Poursuivez ainsi jusqu'à atteindre la valeur maximum_backoff.
  6. Continuez d'attendre et de relancer la requête jusqu'à atteindre le nombre maximal de tentatives, mais n'augmentez pas le temps d'attente entre les tentatives.

où :

  • Le temps d'attente est min(((2^n)+random_number_milliseconds), maximum_backoff), avec n incrémenté de 1 pour chaque itération (requête).
  • random_number_milliseconds est un nombre aléatoire de millisecondes inférieur ou égal à 1 000. Cela permet d'éviter les cas où de nombreux clients se retrouvent synchronisés pour une raison quelconque et effectuent tous une nouvelle tentative en même temps, en envoyant des requêtes par vagues synchronisées. La valeur de random_number_milliseconds est recalculée après chaque nouvelle tentative de la requête.
  • La valeur maximum_backoff est généralement définie sur 32 ou 64 secondes. La valeur appropriée dépend du cas d'utilisation.

Le client peut continuer à réessayer une fois qu'il a atteint la durée maximum_backoff. Au-delà de ce point, il n'est pas nécessaire de continuer à augmenter la durée de l'intervalle exponentiel entre les tentatives. Par exemple, si un client utilise une durée maximum_backoff de 64 secondes, il peut réessayer toutes les 64 secondes après avoir atteint cette valeur. À un moment donné, les clients doivent être empêchés de réessayer indéfiniment.

Le temps d'attente entre les nouvelles tentatives et le nombre de tentatives dépendent de votre cas d'utilisation et des conditions du réseau.

Tarifs

Toute utilisation standard de l'API Google Drive est disponible sans frais supplémentaires. Le dépassement des limites de requêtes de quota devrait entraîner des frais sur votre compte de facturation Google Cloud plus tard en 2026. Pour en savoir plus, consultez Modèle standardisé Google Workspace pour les outils et les API d'agent.

Demander une augmentation du quota

Selon l'utilisation des ressources de votre projet, vous pouvez demander un ajustement du quota. Les appels d'API effectués par un compte de service sont considérés comme utilisant un seul compte. La demande d'ajustement de quota ne garantit pas l'approbation. Les demandes d'ajustement de quota qui augmenteraient considérablement la valeur du quota peuvent nécessiter plus de temps pour être approuvées.

Tous les projets ne sont pas soumis aux mêmes quotas. À mesure que votre utilisation de Google Cloud s'accroît, vos valeurs de quota peuvent devoir augmenter. Si vous prévoyez une augmentation significative de votre utilisation, vous pouvez anticiper cette évolution en demandant des ajustements de quotas sur la page Quotas et limites du système de la console Google Cloud.

Pour en savoir plus, consultez les ressources suivantes :

Quotas du serveur MCP Drive

Le serveur MCP Drive utilise une métrique d'allocation du coût des requêtes. Les tableaux suivants détaillent le coût des requêtes pour chaque méthode du serveur MCP Drive par section :

Quotas MCP Drive

Deux types de quotas sont appliqués :

  • Par minute et par projet : il s'agit du coût des requêtes pour votre projet Google Cloud pendant une minute.

  • Par minute, par utilisateur et par projet : il s'agit du coût des requêtes pour votre projet Google Cloud pendant une minute qu'un utilisateur particulier peut utiliser.

Le tableau suivant détaille ces quotas :

Type de limite d'utilisation Coût des requêtes
Par minute et par projet 325 000
Par minute, par utilisateur et par projet 1 000 000

Quotas de l'ensemble d'outils MCP Drive

Le tableau suivant détaille le coût des requêtes pour chaque ensemble d'outils drivemcp.googleapis.com :

Point de terminaison Outil Coût des requêtes

/mcp/v1

copy_file

50

create_file

50

download_file_content

200

get_file_metadata

5

get_file_permissions

5

list_recent_files

100

read_file_content

200

search_files

100

Pour en savoir plus, consultez la documentation de référence de l'API MCP Drive.