Límites de uso de la API

Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de Groups Settings de forma inapropiada. Las solicitudes excesivas de una API pueden deberse a un error tipográfico inofensivo o a un sistema diseñado de forma ineficiente que realiza llamadas a la API innecesarias. Independientemente de la causa, el estado general del sistema de Google Workspace requiere que se bloquee el tráfico de una fuente específica una vez que alcanza un nivel determinado.

Fallas en las solicitudes a la API

En el caso poco probable de que falle tu solicitud a la API, tu aplicación recibirá una respuesta con un código de estado HTTP. Un código de estado HTTP de 403 tiene información de error que indica qué cuotas de la API se excedieron. La respuesta permite que tu aplicación personalizada detecte errores y tome las medidas adecuadas.

Solicitudes urgentes

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#. Por ejemplo, desglosa 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 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.

Errores basados en el tiempo

Para todos los errores basados en el tiempo (un máximo de N elementos durante X segundos por subproceso), en especial los errores de código de estado 503, recomendamos que tu código detecte la excepción y, con un algoritmo de retirada exponencial, espere un breve retraso antes de volver a intentar la llamada con errores. Un ejemplo de la API de Groups Settings para un subproceso es esperar 5 segundos y volver a intentar la llamada con errores. Si la solicitud se realiza correctamente, repite este patrón para los otros subprocesos. Si la segunda solicitud no se realiza correctamente, tu aplicación debería reducir la frecuencia de la solicitud hasta que una llamada se realice correctamente. 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, reintenta una solicitud de 5 a 7 veces con diferentes tiempos de retraso antes de que tu aplicación devuelva un error al usuario.

Cuotas

Categorías de cuotas de API Cuotas
Consultas por día

Puedes realizar hasta 100,000 consultas por día. Si necesitas capacidad más allá de este límite, puedes enviar una solicitud desde la página Cuotas en la consola de Google Cloud.

Descripción del grupo, tamaño máximo Puedes ingresar una descripción del grupo de hasta 4,096 caracteres.
Nombre del grupo, tamaño máximo El nombre de un grupo puede tener hasta 60 caracteres.
defaultMessageDenyNotificationText El texto de la notificación puede tener hasta 10,000 caracteres. Para obtener más información sobre la propiedad defaultMessageDenyNotificationText, consulta la referencia de la API.
maxMessageBytes El tamaño máximo predeterminado del mensaje es de 1 MB. Para obtener más información sobre la propiedad maxMessageBytes, consulta la referencia de la API.

Límites

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. Los formatos de datos JSON y Atom admiten capacidades completas de lectura y escritura. Para obtener más información, consulta Formatos de datos JSON y Atom.
API de Groups Settings, habilitación Debes activar la API de Directory antes de realizar llamadas a la API de Groups Settings. Para obtener más información, consulta Habilita las APIs de Google Workspace.