Límites de uso

Como la API de Google Drive es un servicio compartido, aplicamos cuotas y limitaciones a asegúrate de que lo usen todos los usuarios y para proteger el rendimiento general del sistema de Google Workspace.

Las notificaciones se entregan a la dirección especificada cuando abrir un canal de notificaciones no se descuentan de tus límites de cuota. Sin embargo, llamadas a changes.watch, channels.stop y Los métodos files.watch no se toman tu cuota.

Si superas una cuota, recibirás una 403: User rate limit exceeded como la respuesta de código de estado HTTP. Verificaciones adicionales de límites de frecuencia en la El backend de Drive también podría generar un 429: Too many requests respuesta. Si esto sucede, debes usar una retirada exponencial. algoritmo y vuelve a intentarlo más tarde. Siempre que te mantengas dentro del cuotas por minuto, no hay límite para la cantidad de solicitudes que puedes hacer por día.

En la siguiente tabla, se detallan los límites de consultas:

Cuotas
Consultas
Cada 60 segundos 12,000
Cada 60 segundos por usuario 12,000

Resuelve errores de cuotas basadas en el tiempo

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

La retirada exponencial es una estrategia estándar de manejo de errores para aplicaciones de red. Los El algoritmo de retirada exponencial vuelve a intentar las solicitudes con tiempos de espera que aumentan exponencialmente entre solicitudes, hasta un tiempo de retirada máximo. Si las solicitudes aún no tienen éxito, es importante que las demoras entre las solicitudes aumenten con el tiempo hasta que la solicitud sea exitosa.

Algoritmo de ejemplo

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

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

Donde:

  • El tiempo de espera es de min(((2^n)+random_number_milliseconds), maximum_backoff), con n incrementado en 1 para cada iteración (solicitud).
  • random_number_milliseconds es una cantidad aleatoria de milisegundos menor que o igual a 1,000. Esto ayuda a evitar casos en los que muchos clientes estén sincronizados alguna situación y todos reintentarán a la vez, enviando solicitudes sincronizadas olas. El valor de random_number_milliseconds se vuelve a calcular después de cada de respuesta ante la solicitud de reintento.
  • maximum_backoff suele ser de 32 o 64 segundos. El valor adecuado depende del caso de uso.

El cliente puede seguir reintentando después de que haya alcanzado el tiempo maximum_backoff. Después de este punto, los reintentos no necesitan continuar con el aumento del tiempo de retirada. Para Por ejemplo, si un cliente usa un tiempo maximum_backoff de 64 segundos, entonces, después de este valor, el cliente puede reintentarlo cada 64 segundos. En algún momento, los clientes deberían evitar que vuelvan a intentarlo de forma indefinida.

El tiempo de espera entre los reintentos y la cantidad de reintentos depende de tu caso de uso. y las condiciones de red.

Precios

Todo uso de la API de Google Drive está disponible sin costo adicional. Exceso de la cuota límites de solicitudes no conlleva cargos adicionales y no se factura tu cuenta.

Solicitar un aumento de cuota

Según el uso que hagas de los recursos en tu proyecto, es posible que quieras solicitar una cuota el aumento de la demanda. Se considera que las llamadas a la API realizadas por una cuenta de servicio usan un cuenta. Solicitar una cuota mayor no garantiza la aprobación. Grande los aumentos de cuota pueden tardar más en aprobarse.

No todos los proyectos tienen las mismas cuotas. A medida que usas cada vez más Google Cloud las cuotas podrían aumentar. Si esperas que se produzca una el aumento en el uso, puedes solicitar ajustes de cuota en la página Cuotas en la consola de Google Cloud.

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