Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa API de Groups Settings de forma inapropiada. Las solicitudes excesivas de una API pueden ser el resultado de un un error tipográfico inofensivo o un sistema diseñado de forma ineficiente que realiza llamadas a la API innecesarias. Independientemente de la causa, bloquear el tráfico de una fuente específica una vez que alcanza cierto nivel necesarias para el estado general del sistema de Google Workspace.
Fallas en las solicitudes a la API
En el improbable caso de que falle la solicitud a la API, tu aplicación recibe un código de estado HTTP
respuesta. 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
acción.
Solicitudes urgentes
Si tus solicitudes deben completarse en un período fijo, envía tus solicitudes en paralelo o usar varios subprocesos en tu aplicación de Java o C#. Por ejemplo, divide tus solicitudes por mes o otro período. En el caso de los subprocesos, intenta comenzar con 10 subprocesos, uno por solicitud. La recomendación de subproceso tiene compensaciones y no es útil en todas las situaciones de la API. Si la cantidad de de solicitudes aumenta demasiado, 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, el
503 errores de código de estado, te recomendamos que tu código detecte la excepción y uses
un
retirada exponencial
algoritmo, espera una pequeña demora 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 se realiza correctamente, repite este
patrón para los otros subprocesos. Si la segunda solicitud no tiene éxito, 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 volver a intentarlo
límite. Por ejemplo, vuelve a intentar una solicitud de 5 a 7 veces con diferentes tiempos de retraso antes de que tu aplicación
devuelve un error al usuario.
Cuotas
| Categorías de cuotas de la API | Cuotas |
|---|---|
| Consultas por día | Puedes realizar hasta 100,000 consultas por día. Si necesitas una capacidad superior este límite, puedes enviar una solicitud desde la La página Cuotas de la consola de Google Cloud |
| Descripción del grupo, tamaño máximo | Puedes ingresar una descripción de 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 el
defaultMessageDenyNotificationText, consulta la
Referencia de la API.
|
maxMessageBytes |
El tamaño máximo predeterminado del mensaje es 1 MB. Para obtener más información sobre 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. JSON y Atom y los formatos de datos 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. |