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 ser el resultado de un error tipográfico inofensivo o el resultado de un sistema con diseño ineficiente que realiza llamadas innecesarias a la API. Sin importar la causa, es necesario bloquear el tráfico de una fuente específica una vez que alcanza cierto nivel para el 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 caso improbable de que tu solicitud de API falle, recibirás una respuesta con un código de estado HTTP. El código de estado 403 contiene información de error sobre entradas incorrectas, mientras que el código de estado HTTP 503 incluye información de error que indica las cuotas de la API que se excedieron. Estas respuestas permiten que tu aplicación personalizada detecte estos errores y tome las medidas adecuadas.
Si necesitas que tus solicitudes se completen 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 solo usuario de forma simultánea. En el caso de las conversaciones, intenta comenzar con 10, una por correo electrónico del usuario. Ten en cuenta que la recomendación de subproceso tiene compensaciones y no es útil para todas las situaciones de API. Si la cantidad de solicitudes es demasiado alta, se producirán errores de cuota.
En el caso de todos los errores basados en el tiempo (un máximo de N elementos por 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 un pequeño retraso antes de reintentar la llamada con errores. Un ejemplo de la API del Centro de alertas para un subproceso es esperar 5 segundos y reintentar la llamada con errores. Si la solicitud se realiza correctamente, repite este patrón para los otros subprocesos. Si la segunda solicitud no es exitosa, tu aplicación debería reducir la frecuencia de la solicitud hasta que una llamada tenga éxito. Por ejemplo, aumenta la demora inicial de 5 segundos a 10 segundos y vuelve a realizar la llamada con errores. Además, establece un límite de reintentos. Por ejemplo, reintentar una solicitud de 5 a 7 veces con tiempos de retraso diferentes antes de que tu aplicación muestre un error al usuario.
| Categorías de límites de API | Límites |
|---|---|
| Tarifas de QPS y QPD del Centro de alertas | La API limita la cantidad de solicitudes de tu proyecto de la Consola de APIs. La cantidad máxima de solicitudes por segundo (QPS del proyecto) del proyecto de API es de 1,000. Además, el número máximo de solicitudes por usuario por segundo (QPS de usuario) es 150.
Si se superan estos límites, el servidor muestra 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 aumento de cuota. Se considera que las llamadas a la API realizadas por una cuenta de servicio usan una sola cuenta. Solicitar una cuota aumentada no garantiza la aprobación. Los aumentos de cuota grandes pueden tardar más en aprobarse.
No todos los proyectos tienen las mismas cuotas. A medida que usas cada vez más Google Cloud con el tiempo, es posible que tus cuotas 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 de Google Cloud Console.
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 la cuota
- Solicita un límite de cuota más alto