Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de informes de forma inapropiada. El exceso de solicitudes de una API podría ser el resultado de un error tipográfico inofensivo o el resultado de un sistema diseñado de forma ineficiente que realiza llamadas innecesarias a la API. Independientemente de 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 improbable caso de que falle la solicitud de la API, recibirás una respuesta de código de estado HTTP. Un código de estado de 403 tiene información de error sobre entradas incorrectas y un código de estado HTTP de 503 tiene información de error que indica qué cuotas de API se excedieron. Estas respuestas permiten que tu aplicación personalizada detecte estos errores y tome las medidas necesarias.
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 las conversaciones, intenta comenzar con 10 conversaciones, una conversación por correo electrónico de 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.
Para todos los errores basados en el tiempo (máximo de N elementos por N segundos por subproceso), especialmente los errores de código de estado 503, recomendamos que tu código detecte la excepción y, mediante un algoritmo de retirada exponencial, espere una pequeña demora antes de volver a intentar la llamada con errores. Un ejemplo de la API de informes 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 debe reducir la frecuencia de la solicitud hasta que la llamada sea exitosa. Por ejemplo, aumenta el retraso inicial de 5 segundos a 10 segundos y vuelve a intentar la llamada con errores. Además, decide 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 |
|---|---|
| Informa las tarifas de QPS y QPD | La API limita la cantidad de solicitudes de tu proyecto de Google Cloud.
El valor predeterminado establecido en la consola de Google Cloud es de 2,400 consultas por minuto, por usuario y por proyecto de Google Cloud.
Puedes aumentar este límite desde la página de cuotas de la API del SDK de Admin de tu proyecto de Google Cloud.
Si se exceden estos límites, el servidor muestra un código de estado HTTP 503. Usa el algoritmo de retirada exponencial cuando vuelvas a intentar tus solicitudes. |
| Categorías de cuota de API | Cuotas |
| maxResults | La cantidad de registros que aparece en cada página de respuesta de una API va de 1 a 1,000 eventos. El valor predeterminado es 1,000 registros. |
| Otros tipos de límites | Limitaciones y lineamientos |
|---|---|
| Formato de datos, predeterminado | El formato de datos predeterminado es JSON. La API también admite el formato Atom. |
| Solicitudes no autorizadas | Google no permite solicitudes no autorizadas a la API. Una solicitud se considera no autorizada si no se proporciona un token de autorización. Para obtener más información, consulta Autoriza solicitudes. |
| Mensajes de advertencia |
|