Como la API de Formularios de Google es un servicio compartido, aplicamos cuotas y limitaciones para garantizar que todos los usuarios la utilicen de forma justa y para proteger el estado general del sistema de Google Workspace.
Si excedes una cuota, por lo general, recibirás una respuesta con el 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. Siempre que no superes las cuotas por minuto que se indican a continuación, no hay
límite para la cantidad de solicitudes que puedes realizar por día.
Nota: Los relojes con formato tienen límites adicionales. Consulta Configura y recibe notificaciones push para obtener más información.
En la siguiente tabla, se detallan los límites de solicitudes:
| Cuotas | |||||||
|---|---|---|---|---|---|---|---|
| Leer solicitudes |
|
||||||
|
Solicitudes de lectura costosas
(se usa para las solicitudes de |
|
||||||
| Escribir solicitudes |
|
||||||
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 las demoras 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:
- Realiza una solicitud a la API de Formularios 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. - 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),nse incrementa en 1 para cada iteración (solicitud). random_number_millisecondses 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 derandom_number_millisecondsse vuelve a calcular después de cada reintento de solicitud.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 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 Formularios de Google 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 se superan 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 la aprobación. Las solicitudes de ajuste de cuota que aumentarían de forma significativa 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 tus valores de cuota deban aumentar. 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: