Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de revendedor de forma inapropiada. El exceso de solicitudes de una API podría ser el resultado de un error tipográfico inofensivo o el resultado de un sistema diseñado de forma ineficiente que realiza llamadas innecesarias a la API. Independientemente de la causa, es necesario bloquear el tráfico de una fuente específica cuando alcanza un 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.
Fallos de solicitudes a la API
En el improbable caso 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 realice las
medidas correspondientes.
Errores basados en el tiempo
Para todos los errores basados en el tiempo (máximo de N elementos por N segundos por subproceso), en especial los errores de código de estado 503, recomendamos que el código detecte la excepción y que, mediante un algoritmo de retirada exponencial, espere un pequeño retraso antes de reintentar la llamada con errores. Un ejemplo de la API de distribuidor 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 debe reducir la frecuencia de la solicitud hasta que una llamada se realice de forma correcta. 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, reintentar una solicitud de 5 a 7 veces con tiempos de retraso diferentes 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 contener 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 por 30 días después de que se genera. |
| Cantidad máxima de usuarios de un cliente | Según tu contrato, la cantidad máxima de usuarios puede ser 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 distribuidor. 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 autenticación y autorización. |
Otros tipos de límites
| Otros tipos de límites | Limitaciones y lineamientos |
|---|---|
| Formato de los datos |
El formato de datos se encuentra en JSON de la notación de objetos de JavaScript.
JSON es un formato común de Internet que proporciona un método para representar estructuras de datos arbitrarias. JSON es un formato de texto completamente independiente del lenguaje, pero usa convenciones familiares para los programadores de la familia C, 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 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. |