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. 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. Sin importar 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 que indica qué cuotas de API se excedieron. La respuesta permite que tu aplicación personalizada detecte 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, espera un pequeño retraso antes de reintentar la llamada con errores. Un ejemplo de la API de Groups Settings 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, tu aplicación debe reducir la frecuencia de la solicitud hasta que una 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 le muestre un error al usuario.

Cuotas

Categorías de cuota de la 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 300 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 para los mensajes 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.