Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de Email Audit 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 cuando alcanza cierto nivel para mantener el buen estado general del sistema de Google Workspace. Los límites ayudan a garantizar que las acciones de un desarrollador no afecten 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 contiene información de error sobre la entrada incorrecta, y el código de estado HTTP 503 contiene información de error que indica qué cuotas de la API se superaron. 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 lotes pequeños de correos electrónicos de diferentes usuarios en lugar de agregar o quitar muchos correos electrónicos de un usuario simultáneamente. En el caso de los hilos, intenta comenzar con 10 hilos, 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 producen errores de cuota. Otro ejemplo de compensación es la cuota de la API de Email Audit para la tasa máxima general de carga de mensajes. La tasa de carga es de una solicitud a la API por segundo y por usuario, sin importar cuántos subprocesos realicen solicitudes de carga.
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, mediante un algoritmo de retirada exponencial, espere un pequeño retraso antes de volver a intentar la llamada fallida. Un ejemplo de la API de Email Audit 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 la solicitud 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, reintenta una solicitud de 5 a 7 veces con diferentes tiempos de demora antes de que tu aplicación devuelva un error al usuario.
En la siguiente tabla, se enumeran los límites de la API de Email Audit:
| Categorías de límites de la API | Límites |
|---|---|
| Creación de archivos de buzón encriptados |
La creación de archivos de buzón de correo electrónico encriptados puede tardar varios días en prepararse, según el tamaño. |
| Archivos de buzón encriptados, errores con la eliminación |
Cuando se borra un buzón de correo electrónico encriptado y se producen errores, la solicitud recibe el estado |
En la siguiente tabla, se enumeran las cuotas de la API de Email Audit:
| Categorías de cuotas de API | Cuotas |
|---|---|
| Tokens de autenticación de ClientLogin |
Válido por 24 horas. El error es |
| Formatos de fecha |
Convierte todas las fechas al formato de hora universal coordinada (UTC) antes de usarlas con la API de Email Audit. Para obtener más información, consulta el convertidor de UTC. |
|
Archivos de buzón de correo electrónico encriptados, resúmenes de |
Google conserva los archivos de buzón de correo encriptados durante 3 semanas. Después de ese tiempo, se borran. Es responsabilidad del administrador del dominio descargar estos archivos de buzón de correo dentro de este período. |
| Formato de archivos de buzón encriptados |
Los archivos de buzón encriptados están en formato mbox. |
| Archivos de buzón encriptados y solicitudes máximas de creación |
La cantidad máxima de solicitudes de creación de exportación de buzones por día es de 100 solicitudes en total de todos los administradores del dominio. |
| Estado del archivo de buzón encriptado, paginación |
Cuando se solicita el estado de todas las solicitudes de buzón, las respuestas pueden
devolver grandes cantidades de datos. La API de Email Audit agrupa estos datos en páginas, cada una con un máximo de 100 entradas y un URI en una etiqueta |
| Supervisor de correo electrónico |
La cantidad máxima de solicitudes de supervisión de correo electrónico por día es de 1,500. Este límite se aplica al dominio y abarca todas las solicitudes que realice cualquier administrador durante el día. |
| Clave pública |
La API de Email Audit solo admite una clave. La clave pública usa el software GNU Privacy Guard (GPG). Está en formato PGP y es una clave de encriptación RSA codificada en ASCII. Antes de subir la clave pública, primero debes convertirla en una cadena codificada en Base64. El archivo de clave pública debe leerse con el conjunto de caracteres US-ASCII (IANA es el nombre preferido del conjunto de caracteres para ASCII). |
| Buscando |
Los parámetros |