API de migración de grupos: límites y cuotas

Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de Groups Migration de forma inapropiada. El exceso de solicitudes de una API puede ser el resultado de un error tipográfico inofensivo o 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 un nivel determinado para el estado general del sistema de Google Workspace.

Fallas de solicitudes a la API

En el caso improbable de que la solicitud a la API falle, la aplicación recibe una respuesta de código de estado HTTP. Un código de estado HTTP de 403 tiene información de error sobre una entrada incorrecta, y un código de estado HTTP de 503 tiene información de error que indica qué cuotas de API se superaron. Estas respuestas permiten que tu aplicación personalizada detecte estos errores y tome las medidas adecuadas.

Solicitudes urgentes

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, 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 tu código detecte la excepción y, mediante un algoritmo de retirada exponencial, espere un pequeño retraso antes de reintentar la llamada con errores. Un ejemplo de la API de Groups Migration 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, define un límite de reintentos. Por ejemplo, reintenta 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 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. Cuando se suben correos electrónicos migrados, el tipo de contenido de una solicitud debe usar 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 Groups Migration 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 razones contractuales. No uses la API de Groups Migration si se requiere la ubicación de los datos para tu cuenta.
Inserciones de mensajes paralelos La API de migración de grupos admite solicitudes paralelas de inserciones de correo electrónico en diferentes archivos de grupo. Sin embargo, la API de Groups Migration no admite inserciones de mensajes paralelos en el mismo archivo de grupo. Tampoco se admiten las solicitudes por lotes en esta versión de la API de migración de grupos.
Solicitudes no autorizadas La API de migración de grupos no acepta solicitudes no autorizadas. Una solicitud se considera no autorizada si no se proporciona un token de autorización. Para obtener más detalles, consulta Más información sobre autenticación y autorización.