Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API del Centro de alertas de forma inapropiada. El exceso de solicitudes de una API puede deberse a un error tipográfico inofensivo o a un sistema diseñado de manera ineficiente que realiza llamadas innecesarias a la API. Sea cual sea la causa, es necesario bloquear el tráfico de una fuente específica, una vez que alcanza cierto nivel, para mantener el buen estado general del sistema de Google Workspace. Garantiza que las acciones de un desarrollador no puedan afectar negativamente a la comunidad en general.
En el improbable caso de que falle tu solicitud a la API, recibirás una respuesta con un código de estado HTTP. El código de estado 403 tiene información de error sobre la entrada incorrecta, y el código de estado HTTP 503 tiene información de error que indica qué cuotas de la API se excedieron. Estas respuestas permiten que tu aplicación personalizada detecte estos errores y tome las medidas adecuadas.
Si tus solicitudes deben completarse en un período fijo, envíalas en paralelo o usa varios subprocesos en tu aplicación de Java o C#. Un ejemplo de solicitudes paralelas es solicitar pequeños lotes de correos electrónicos de diferentes usuarios en lugar de agregar o quitar muchos correos electrónicos de un usuario de forma simultánea. En el caso de los subprocesos, intenta comenzar con 10, uno por cada correo electrónico del usuario. Ten en cuenta que la recomendación de subprocesos tiene ventajas y desventajas, y no es útil para todas las situaciones de la API. Si la cantidad de solicitudes es demasiado alta, se producirán errores de cuota.
Para todos los errores basados en el tiempo (un máximo de N elementos durante N segundos por subproceso), en especial los errores de código de estado 503, recomendamos que tu código detecte la excepción y, con un algoritmo de retirada exponencial, espere un pequeño retraso antes de volver a intentar la llamada fallida. Un ejemplo de la API de Alert Center para un subproceso es esperar 5 segundos y volver a intentar la llamada fallida. Si la solicitud se realiza correctamente, repite este patrón para los demás subprocesos. Si la segunda solicitud no se realiza correctamente, tu aplicación debe reducir la frecuencia de las solicitudes hasta que se realice una llamada correctamente. Por ejemplo, aumenta la demora inicial de 5 segundos a 10 segundos y vuelve a intentar la llamada fallida. Además, decide un límite de reintentos. Por ejemplo, vuelve a intentar una solicitud de 5 a 7 veces con diferentes tiempos de demora antes de que tu aplicación muestre un error al usuario.
| Categorías de límites de la API | Límites |
|---|---|
| Tasas de QPS y QPD del Centro de alertas | La API limita la cantidad de solicitudes para tu proyecto de la Consola de APIs. La cantidad máxima de solicitudes por segundo (QPS del proyecto) del proyecto de la API es de 1,000. Además, la cantidad máxima de solicitudes por usuario y por segundo (QPS del usuario) es de 150.
Si se exceden estos límites, el servidor devuelve un código de estado HTTP |
| Otros tipos de límites | Limitaciones y lineamientos |
|---|---|
| Formato de datos, predeterminado | El formato de datos predeterminado es JSON. |
| Solicitudes no autorizadas | Google no permite solicitudes no autorizadas a esta API. Una solicitud se considera no autorizada si no se proporciona un token de autorización. Para obtener más información, consulta Cómo autorizar solicitudes. |
Solicita un aumento de la cuota por proyecto
Según el uso de recursos de tu proyecto, es posible que desees solicitar un ajuste de cuota. Las llamadas a la API realizadas por una cuenta de servicio se consideran como si se usara una sola cuenta. Solicitar una cuota ajustada no garantiza la 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 uses cada vez más Google Cloud 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 de la consola de Google Cloud.
Para obtener más información, consulta los siguientes recursos:
- Acerca de los ajustes de cuota
- Consulta el uso y los límites de tu cuota actual
- Solicita un límite de cuota más alto