Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de Reseller de manera inadecuada. Las solicitudes excesivas de una API pueden deberse a un error tipográfico inofensivo o a un sistema diseñado de manera ineficiente que realiza llamadas innecesarias a la API. Sea cual sea la causa, es necesario bloquear el tráfico de una fuente específica cuando alcanza cierto nivel para mantener el buen estado general del sistema de Google Workspace. Se asegura de que las acciones de un desarrollador no puedan afectar negativamente a la comunidad en general.
Fallas en las solicitudes a la API
En el caso improbable de que falle tu solicitud a la API, tu aplicación recibirá una respuesta de código de estado HTTP. Un código de estado 403 tiene información de error sobre una entrada incorrecta, y un código de estado HTTP 503 tiene 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.
Errores basados en el tiempo
Para todos los errores basados en el tiempo (máximo de N elementos durante N segundos por subproceso), en especial los errores de código de estado 503, te recomendamos que tu código capture la excepción y, con un algoritmo de retirada exponencial, espere una pequeña demora antes de volver a intentar la llamada fallida. Un
ejemplo de la API de Reseller para un subproceso
es esperar 5 segundos y volver a intentar la llamada que falló. Si la solicitud se realiza correctamente, repite este patrón para los otros subprocesos. Si la segunda solicitud no se realiza de forma correcta, tu aplicación debería reducir la frecuencia de la solicitud hasta que se realice una llamada correctamente. Por ejemplo, aumenta el retraso inicial de 5 segundos a 10 segundos y vuelve a intentar la llamada que falló. Además, establece un límite de reintentos.
Por ejemplo, vuelve a intentar una solicitud de 5 a 7 veces con diferentes tiempos de demora antes de que tu aplicación le muestre un error al usuario.
Límites
| Categorías de límites de API | Límites |
|---|---|
Suscripción purchaseOrderId |
Esta propiedad acepta hasta 80 caracteres de texto sin formato. |
Suscripción maxResults |
La cadena de consulta maxResults puede tener entre 1 y 100 resultados.
El valor predeterminado es 20 resultados.
|
Token de transferencia (customerAuthToken) |
El token de transferencia de un cliente es válido durante 30 días después de que se genera. |
| Cantidad máxima de usuarios por cliente | Según tu contrato, la cantidad máxima de usuarios puede ser de 50,000 o la cantidad máxima definida en tu contrato de revendedor. |
| Solicitudes no autorizadas | Google no permite solicitudes no autorizadas a la API de Reseller. Una solicitud se considera no autorizada si no se proporciona un token de autorización. Para obtener más información, consulta Obtén información sobre la autenticación y la autorización. |
Otros tipos de límites
| Otros tipos de límites | Limitaciones y lineamientos |
|---|---|
| Formato de los datos |
El formato de los datos está en la notación de objetos de JavaScript JSON.
JSON es un formato de Internet común que proporciona un método para representar estructuras de datos arbitrarias. JSON es un formato de texto que es completamente independiente del lenguaje, pero usa convenciones que son familiares para los programadores de la familia de lenguajes C, incluidos C, C++, C#, Java, JavaScript, Perl y Python. |
| Formato de hora | Todas las fechas y horas se encuentran en el convertidor de época en milisegundos. Este formato se aplica a los valores de la hora de creación de la suscripción, las horas de inicio y finalización del compromiso de un plan y la hora de finalización de una prueba gratuita de 30 días. |