Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de Enterprise License Manager de manera inapropiada. El exceso de solicitudes de una API puede ser el resultado de un error tipográfico inofensivo o el resultado de un sistema con diseño 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 cierto nivel para el estado general del sistema de Google Workspace. Garantiza que las acciones de un desarrollador no puedan afectar negativamente a la comunidad en general.
En el caso improbable de que tu solicitud de API falle, recibirás una respuesta con un código de estado HTTP. El código de estado 403 contiene información de error sobre entradas incorrectas, y el código de estado HTTP 503 contiene información de error que indica qué cuotas de API se excedieron. Estas respuestas permiten que tu aplicación personalizada detecte estos errores y tome las medidas adecuadas.
Si necesitas que tus solicitudes se completen en un período fijo, envía tus solicitudes en lotes. Según el propósito de tu API y si la cantidad de solicitudes es demasiado alta, se producirán errores de cuota.
Si no puedes usar la función recomendada de solicitudes por lotes a la API, usa el algoritmo de retirada exponencial. Para todos los errores basados en el tiempo (un máximo de N elementos para X segundos por subproceso), en especial los errores de código de estado 503, te recomendamos que tu código detecte la excepción y, con un algoritmo de retirada exponencial, espere un pequeño retraso antes de reintentar la llamada con errores. Un ejemplo de la API de Enterprise License Manager 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 es exitosa, tu aplicación debería reducir la frecuencia de la solicitud hasta que una llamada tenga éxito. Por ejemplo, aumenta la demora inicial de 5 segundos a 10 segundos y vuelve a realizar la llamada con errores. Además, establece 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 muestre un error al usuario.
| Categorías de cuota de la API | Cuotas |
|---|---|
| Consultas por segundo (QPS) | La cuota de QPS es de 1. |
| Categorías de límites de API | Límites |
|---|---|
| String de consulta maxResults | El tamaño máximo de maxResults es 100. |
| Otros tipos de límites | Limitaciones y lineamientos |
|---|---|
| Solicitudes por lotes |
La API admite el envío de solicitudes por lotes. |
| Formato de datos en las respuestas de la API | El formato de datos de la respuesta es JavaScript Object Notation (JSON). |
| Habilitación de la API de Enterprise License Manager | Se debe habilitar la API de aprovisionamiento antes de realizar llamadas a la API de Enterprise License Manager. En tu panel de control, ve a la página Configuración de la pestaña Usuarios y grupos y habilita la API de aprovisionamiento. Guarda los cambios. Además, se debe habilitar y activar el servicio de Grupos de Google. |
| Solicitudes no autorizadas | La API no acepta solicitudes no autorizadas. Una solicitud se considera no autorizada si no se proporciona un token de autorización. Para obtener más información, consulta Cómo autorizar solicitudes. |