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. |