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 Data Transfer de forma inadecuada. El exceso de solicitudes de una API puede ser el resultado de un error tipográfico inofensivo o un sistema diseñado de forma ineficiente que realiza llamadas innecesarias a la API. Sin importar la causa, es necesario bloquear el tráfico de una fuente específica cuando alcanza un nivel determinado para el estado general del sistema de Google Workspace. Garantiza que las acciones de un desarrollador no puedan afectar negativamente a toda la comunidad.

Fallas de solicitudes a la API

En el caso improbable de que falle la solicitud a la API, la aplicación recibirá 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.

Completar solicitudes en un período fijo

Si debes completar tus solicitudes en un período fijo, envíalas en paralelo o usa varios subprocesos en tu aplicación de Java o C#. Por ejemplo, divide tus solicitudes por mes o por otro período. En el caso de los subprocesos, intenta comenzar con 10 subprocesos, uno por solicitud. La recomendación del 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.

Errores basados en el tiempo

Para todos los errores basados en el tiempo (un máximo de N elementos por X segundos por subproceso), en especial los errores de código de estado 503, recomendamos que el código detecte la excepción y, mediante el uso de un algoritmo de retirada exponencial, espere un pequeño retraso antes de reintentar la llamada con errores. Un ejemplo de la API de Data Transfer para un subproceso es esperar 5 segundos y reintentar la llamada con errores. Si la solicitud es exitosa, repite este patrón para los otros subprocesos. Si la segunda solicitud no es exitosa, la 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, elige 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 le muestre un error al usuario.

Límites

Categorías de límites de API	Límites
Consultas por segundo (QPS)	El límite de proyectos para desarrolladores es de 10 consultas por segundo (QPS) por cuenta.

Cuotas

Categorías de cuota de la API	Cuotas
Cantidad máxima de solicitudes a la API por día	La cantidad máxima de solicitudes a la API por día es de 500,000.
Archivo, vencimiento de mensajes	Los archivos del grupo no vencen. Los mensajes permanecerán en un archivo hasta que se borre el grupo. La política de retención de correo electrónico no afecta los mensajes del archivo de un grupo.
Tamaño del mensaje de correo electrónico	El tamaño máximo del mensaje de correo electrónico es de 25 MB. Este límite incluye los encabezados de metadatos, el cuerpo y los archivos adjuntos del mensaje.

Otros tipos de límites

Otros tipos de límites	Limitaciones y lineamientos
Formatos de tipos de contenido	Los mensajes de correo electrónico deben tener el formato de texto estándar RFC 822. El formato de tipo de contenido de una solicitud para subir correos electrónicos migrados usa el encabezado Content-type: message/rfc822.
Formato de datos en las respuestas de la API	El formato de datos de la respuesta es JavaScript Object Notation (JSON).
Políticas de ubicación de datos	La API de Data Transfer no admite políticas de ubicación de datos que requieran que los datos se almacenen en límites geográficos o políticos específicos por motivos contractuales. No uses la API de Data Transfer si se requiere la ubicación de los datos para tu cuenta.
Inserciones de mensajes paralelos	La API de Data Transfer admite solicitudes paralelas de inserciones de correo electrónico en diferentes archivos de grupo. Sin embargo, la API de Data Transfer no admite inserciones de mensajes paralelas en el mismo archivo de grupo. Esta versión de la API tampoco admite solicitudes por lotes.
Solicitudes no autorizadas	La API de Data Transfer no acepta solicitudes no autorizadas. Una solicitud se considera no autorizada si no se proporciona un token de autorización.