Como la API de Documentos de Google es un servicio compartido, aplicamos cuotas y limitaciones para asegurarnos de que todos los usuarios la usen de forma justa y proteger el estado general del sistema de Google Workspace.
Si superas una cuota, por lo general, recibirás una respuesta de código de estado HTTP 429: Too many requests. Si esto sucede, debes usar un algoritmo de retirada exponencial y volver a intentarlo más tarde.
En la siguiente tabla, se detallan los límites de solicitudes:
| Cuotas | |||||
|---|---|---|---|---|---|
| Leer solicitudes |
|
||||
| Escribir solicitudes |
|
||||
Resuelve errores de cuotas basadas en el tiempo
Para todos los errores basados en el tiempo (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 asegurarse 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 vuelve a intentar las solicitudes con tiempos de espera que aumentan exponencialmente entre las 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 hasta que estas se completen 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:
- Hacer una solicitud a la API de Documentos de Google
- Si la solicitud falla, espera 1 +
random_number_millisecondsy vuelve a intentar la solicitud. - Si la solicitud falla, espera 2 +
random_number_millisecondsy vuelve a intentar la solicitud. - Si la solicitud falla, espera 4 +
random_number_millisecondsy vuelve a intentar la solicitud. - Y así sucesivamente, hasta un tiempo de
maximum_backoff. - Continúa con la espera y los reintentos hasta un número máximo de reintentos, 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), connincrementado en 1 para cada iteración (solicitud). random_number_millisecondses un número aleatorio de milisegundos menor o igual que 1,000. Esto ayuda a evitar los casos en los que muchos clientes se sincronizan por alguna situación y todos realizan el reintento a la vez, lo que envía solicitudes en oleadas sincronizadas. El valor derandom_number_millisecondsse vuelve a calcular después de cada solicitud de reintento.maximum_backoffsuele 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 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 maximum_backoff de 64 segundos, luego 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 de uso y las condiciones de la red.
Precios
Todo uso de la API de Documentos de Google está disponible sin costo adicional. Si superas los límites de solicitudes de cuota, no se te cobrarán cargos adicionales y no se facturará tu cuenta.
Solicitar un aumento de cuota
Según el uso que hagas de los recursos de tu proyecto, es posible que desees solicitar un aumento de la cuota. Las llamadas a la API de una cuenta de servicio se consideran que usan una sola cuenta. Solicitar un aumento de cuota no garantiza la aprobación. Los incrementos de cuota grandes pueden tardar más tiempo 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 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 de la consola de Google Cloud.
Para obtener más información, consulta los siguientes recursos:
- Acerca de las solicitudes de aumento de cuota
- Consulta el uso y los límites actuales de tu cuota
- Solicita un límite de cuota más alto