Límites y cuotas de uso

Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de Alert Center de forma inadecuada. Las solicitudes excesivas de una API pueden 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. Esto ayuda a garantizar que las acciones de un desarrollador no puedan afectar negativamente a la comunidad más grande.

En el improbable caso de que falle tu solicitud a la API, recibirás una respuesta con un código de estado HTTP. Un código de estado 403 tiene información de error sobre la entrada incorrecta, y un 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 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 subprocesos, un subproceso por correo electrónico del usuario. Ten en cuenta que la recomendación de subprocesos tiene 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, te recomendamos que tu código detecte la excepción y, con un algoritmo de retirada exponencial, espere una pequeña demora 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 es exitosa, repite este patrón para los demás subprocesos. Si la segunda solicitud no es exitosa, tu aplicación debe reducir la frecuencia de la solicitud hasta que una llamada sea exitosa. 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 reintento. 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 Google Cloud. La cantidad máxima de solicitudes por segundo del proyecto de la API (QPS del proyecto) es de 1,000. Además, la cantidad máxima de solicitudes por usuario por segundo (QPS del usuario) es de 150.

Si se exceden estos límites, el servidor muestra un código de estado HTTP 503 código de estado. Usa el algoritmo de retirada exponencial cuando vuelvas a intentar tus solicitudes.

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 cuota por proyecto

Según el uso que hagas de los recursos de tu proyecto, es posible que desees solicitar un ajuste de cuota. Las llamadas a la API de una cuenta de servicio se consideran como si usaran una sola cuenta. Solicitar una cuota ajustada no garantiza la aprobación. Las solicitudes de ajuste de cuota que aumenten 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: