Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API del revendedor 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 diseñado de manera ineficiente que realiza llamadas innecesarias a la API. Sin importar la causa, es necesario bloquear el tráfico de una fuente específica cuando alcanza un nivel determinado para el estado general del sistema de Google Workspace. Garantiza que las acciones de un desarrollador no puedan afectar negativamente a toda la comunidad.
Fallas en las solicitudes a la API
En el caso improbable de que falle la solicitud a la API, la aplicación recibirá una respuesta de código de estado HTTP. Un código de estado de 403 tiene información de error sobre entradas incorrectas y un código de estado HTTP de 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 (un máximo de N elementos por N segundos por subproceso), en especial los errores de código de estado 503, recomendamos que tu código detecte la excepción y, mediante el uso de un algoritmo de retirada exponencial, espera una pequeña demora antes de reintentar la llamada con errores. Un ejemplo de la API del revendedor 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 se realiza correctamente, la 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 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.
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 para un cliente | Según tu contrato, la cantidad máxima de usuarios puede ser 50,000 o el máximo definido en tu contrato de revendedor. |
| Solicitudes no autorizadas | Google no permite solicitudes no autorizadas a la API para revendedores. Una solicitud se considera no autorizada si no se proporciona un token de autorización. Para obtener más información, consulta Más 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 se encuentra en el formato JSON de la notación de objetos de JavaScript.
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 completamente independiente del lenguaje, pero usa convenciones conocidas por los programadores de la familia C de lenguajes, como C, C++, C#, Java, JavaScript, Perl y Python. |
| Formato de hora | Todas las fechas y horas se encuentran en el conversor de época en milisegundos. Este formato se aplica a los valores de 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. |