Límites de uso

Como la API de Google Drive es un servicio compartido, aplicamos cuotas y limitaciones para garantizar que todos los usuarios la usen de forma justa y para proteger el rendimiento general del sistema de Google Workspace.

Los límites se definen en términos de unidades de cuota, una unidad de medida abstracta que representa el uso de recursos de Google Drive.

Cuotas de la API de Drive

Se aplican tres tipos de cuotas:

  • Por minuto por proyecto: Es la cantidad de unidades de cuota que puede usar tu proyecto de Google Cloud en un minuto.

  • Por minuto, por usuario y por proyecto: Es la cantidad de unidades de cuota que un usuario en particular puede usar en tu proyecto de Cloud. Este límite tiene como objetivo ayudarte a garantizar una distribución justa del uso entre tus usuarios.

  • Por día por proyecto: Define la cantidad máxima de bytes que tu proyecto de Google Cloud puede transferir en un período de 24 horas antes de que se apliquen cargos.

En la siguiente tabla, se detallan estos límites:

Tipo de límite de uso Límite
Por minuto, por proyecto 1,000,000 de unidades de cuota
Por minuto por usuario por proyecto 325,000 unidades de cuota
Por día y por proyecto 1 TB

Si excedes una cuota, recibirás una respuesta con el código de estado HTTP 403: User rate limit exceeded. Las verificaciones adicionales del límite de frecuencia en el backend de Drive también pueden generar una respuesta 429: Rate limit exceeded. Si esto sucede, debes usar un algoritmo de retirada exponencial y volver a intentarlo más tarde.

Límite de facturación diario

Este límite por día y por proyecto define la cantidad máxima de unidades de cuota que puede usar tu proyecto de Google Cloud en un período de 24 horas antes de que se apliquen cargos.

El uso que no supere este umbral no generará cargos adicionales y no se facturará a tu cuenta de Google Cloud. Los detalles completos de la facturación se compartirán más adelante en 2026 con al menos 90 días de anticipación antes de que se apliquen los cambios.

No puedes solicitar un aumento de este límite de umbral diario.

En la siguiente tabla, se detalla el límite:

Tipo de límite de umbral Límite
Por día y por proyecto 400,000,000 de unidades de cuota

Para obtener más información, consulta Modelo estandarizado de Google Workspace para herramientas y APIs de agentes.

Costos de unidades de cuota por método

La cantidad de unidades de cuota consumidas por solicitud varía según el método llamado, como se describe en las siguientes tablas:

Métodos de lectura (5 unidades de cuota)

Método
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

Métodos de lista (100 unidades de cuota)

Método
drive.accessproposals.list
drive.apps.list
drive.changes.list, drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list, drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

Métodos de edición (50 unidades de cuota)

Método
drive.approvals.decline
drive.children.delete, drive.children.insert
drive.comments.create, drive.comments.delete, drive.comments.insert, drive.comments.patch y drive.comments.update
drive.drives.create, drive.drives.delete, drive.drives.hide, drive.drives.insert, drive.drives.unhide y drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete, drive.parents.insert
drive.permissions.create, drive.permissions.delete, drive.permissions.insert, drive.permissions.patch y drive.permissions.update
drive.properties.delete, drive.properties.insert, drive.properties.patch, drive.properties.update
drive.replies.create, drive.replies.delete, drive.replies.insert, drive.replies.patch y drive.replies.update
drive.revisions.delete, drive.revisions.patch, drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

Métodos de descarga (200 unidades de cuota)

Método
drive.files.download, drive.files.export, drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

Otros métodos (5 unidades de cuota)

Método
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds, drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

Limitaciones adicionales

Cuando trabajas con la API de Drive, se aplican las siguientes restricciones:

  • Los usuarios de Google Workspace solo pueden subir 750 GB por día entre Mi unidad y todas las unidades compartidas. Este límite también se aplica a las copias.

  • Los usuarios que alcancen el límite de 750 GB o suban un archivo de más de 750 GB no podrán subir ni copiar archivos adicionales hasta que hayan transcurrido 24 horas.

  • El tamaño máximo de archivo que los usuarios pueden subir es de 5 TB. Solo se completa la carga del primer archivo que supera el límite. El tamaño máximo de archivo que los usuarios pueden copiar es de 750 GB.

  • Las notificaciones que se envían a la dirección especificada cuando se abre un canal de notificaciones no se consideran para los límites de cuota. Sin embargo, las llamadas a los métodos changes.watch, channels.stop y files.watch sí se descuentan de tu cuota.

  • Siempre que te mantengas dentro de las cuotas por minuto, no hay límite para la cantidad de solicitudes que puedes realizar por día.

  • Según el tipo de cuenta de Google Workspace, hay límites de almacenamiento en Drive adicionales.

Cómo resolver errores de cuota basados en el tiempo

Para todos los errores basados en el tiempo (un máximo de N solicitudes por X minutos), te recomendamos que tu código detecte la excepción y use una retirada exponencial truncada para asegurarte de que tus dispositivos no generen una carga excesiva.

La retirada exponencial es una estrategia estándar de manejo de errores para aplicaciones de red. Un algoritmo de retirada exponencial reintenta las solicitudes a través del aumento exponencial de los tiempos de espera entre solicitudes, hasta un tiempo de retirada máximo. Si las solicitudes siguen sin tener éxito, es importante que los retrasos entre las solicitudes aumenten con el tiempo hasta que la solicitud se realice correctamente.

Algoritmo de ejemplo

Un algoritmo de retirada exponencial vuelve a intentar las solicitudes de forma exponencial, lo que aumenta el tiempo de espera entre los reintentos hasta un tiempo de retirada máximo. Por ejemplo:

  1. Realiza una solicitud a la API de Google Drive.
  2. Si la solicitud falla, espera 1 + random_number_milliseconds y vuelve a intentar la solicitud.
  3. Si la solicitud falla, espera 2 + random_number_milliseconds y vuelve a intentar la solicitud.
  4. Si la solicitud falla, espera 4 + random_number_milliseconds y vuelve a intentar la solicitud.
  5. Y así sucesivamente, hasta un tiempo de maximum_backoff.
  6. Sigue con la espera y los reintentos hasta llegar a una cantidad máxima, pero no aumentes el período de espera entre los reintentos.

Donde:

  • El tiempo de espera es min(((2^n)+random_number_milliseconds), maximum_backoff), n se incrementa en 1 para cada iteración (solicitud).
  • random_number_milliseconds es un número al azar de milisegundos menor o igual que 1,000. Esto ayuda a evitar casos en los que muchos clientes se sincronizan por alguna situación y todos vuelven a intentarlo a la vez, lo que envía solicitudes en oleadas sincronizadas. El valor de random_number_milliseconds se vuelve a calcular después de cada reintento de solicitud.
  • maximum_backoff suele ser de 32 o 64 segundos. El valor apropiado depende del caso de uso.

El cliente puede seguir reintentando después de que alcanza el tiempo de maximum_backoff. Después de este punto, los reintentos no necesitan continuar con el aumento del tiempo de retirada. Por ejemplo, si un cliente usa un tiempo de maximum_backoff de 64 segundos, después de alcanzar este valor, el cliente puede volver a intentarlo cada 64 segundos. En algún momento, se debe evitar que los clientes vuelvan a intentarlo de forma ilimitada.

El tiempo de espera entre los reintentos y la cantidad de reintentos depende del caso práctico y las condiciones de la red.

Precios

Todo el uso estándar de la API de Google Drive está disponible sin costo adicional. Se prevé que, más adelante en 2026, se generen cargos en tu cuenta de facturación de Google Cloud si superas los límites de solicitudes de cuota. Para obtener más información, consulta el modelo estandarizado de Google Workspace para herramientas y APIs de agentes.

Solicita un aumento de la cuota

Según el uso que hagas de los recursos de tu proyecto, es posible que desees solicitar un ajuste de cuota. Se considera que las llamadas a la API que realiza una cuenta de servicio usan una sola cuenta. Solicitar un ajuste de cuota no garantiza su aprobación. Las solicitudes de ajuste de cuota que aumentarían significativamente el valor de la cuota pueden tardar más en aprobarse.

No todos los proyectos tienen las mismas cuotas. A medida que tu uso de Google Cloud aumenta con el tiempo, es posible que debas aumentar los valores de tus cuotas. Si prevés un aumento considerable en el uso, puedes solicitar ajustes en la cuota de forma proactiva en la página Cuotas y límites del sistema de la consola de Google Cloud.

Para obtener más información, consulta los siguientes recursos:

Cuotas del servidor de MCP de Drive

El servidor de MCP de Drive usa una métrica de asignación de costos de consultas. En las siguientes tablas, se detalla el costo de consulta para cada método del servidor de MCP de Drive por sección:

Cuotas de MCP de Drive

Se aplican dos tipos de cuotas:

  • Por minuto por proyecto: Este es el costo de la consulta para tu proyecto de Google Cloud durante un minuto.

  • Por minuto por usuario por proyecto: Este es el costo de la consulta para tu proyecto de Google Cloud durante un minuto que puede usar cualquier usuario en particular.

En la siguiente tabla, se detallan estas cuotas:

Tipo de límite de uso Límite
Por minuto, por proyecto 325,000
Por minuto por usuario por proyecto 1,000,000

Cuotas del conjunto de herramientas de MCP de Drive

En la siguiente tabla, se detalla el costo de la consulta para cada conjunto de herramientas de drivemcp.googleapis.com:

Extremo Herramienta Costo de las consultas

/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

Para obtener más información, consulta la referencia de la API de MCP de Drive.