Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que utiliza la API de Admin Settings de forma inapropiada. Las solicitudes excesivas de una API pueden deberse a un error tipográfico inofensivo o a un sistema de 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 un nivel determinado para el estado general del sistema de Google Workspace. Garantiza que las acciones de un desarrollador no tengan un impacto negativo en la comunidad.
En el caso improbable de que la solicitud a la API falle, recibirás 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 superaron. Estas respuestas permiten que tu aplicación personalizada detecte estos errores y realice las acciones correspondientes.
Si tus solicitudes deben completarse en un período fijo, envíalas en paralelo o usa varios subprocesos en tu aplicación de Java o C#. Por ejemplo, divide tus solicitudes por mes o por otro período. En el caso de los subprocesos, intenta comenzar con 10 subprocesos, uno por solicitud. Ten en cuenta que la recomendación de subprocesos tiene compensaciones y no es útil para todas las situaciones de API. Si la cantidad de solicitudes es demasiado alta, se generarán errores de cuota.
Para todos los errores que se basan en el tiempo (máximo de N cosas por X segundos por subproceso), especialmente los errores del código de estado 503, recomendamos que su código detecte la excepción y, mediante un algoritmo de retirada exponencial, espere un pequeño retraso antes de reintentar la llamada con errores. Un ejemplo de la API de configuración de correo electrónico para una conversación consiste en esperar 5 segundos y reintentar la llamada con errores. Si la solicitud se realiza correctamente, repite este patrón para los demás subprocesos. Si la segunda solicitud no es exitosa, tu aplicación debería reducir la escala en la frecuencia hasta que una llamada sea exitosa. Por ejemplo, aumente el retraso inicial de 5 segundos a 10 segundos y vuelva a intentar la llamada con errores. Además, establece un límite de reintentos. Por ejemplo, vuelve a enviar una solicitud entre 5 y 7 veces con diferentes tiempos de demora antes de que tu aplicación le muestre un error al usuario.
| Categorías de cuota de API | Cuotas |
|---|---|
| Tokens de autenticación de ClientLogin | Válido durante 24 horas. El error es “El token 401 caducó”. |
| Genera claves públicas y privadas | Con tu proveedor de identidad, genera un conjunto de claves públicas y privadas con los algoritmos de DSA o RSA. La clave pública está en un certificado con formato X.509. Para obtener más información sobre las claves de firma de inicio de sesión único basadas en SAML, consulta Genera claves y certificados para el servicio de inicio de sesión único de Google Workspace. |
| Logotipo | El archivo de imagen del logotipo de la cuenta puede estar en formato JPEG, PNG o GIF. El tamaño recomendado es de 143 x 59 píxeles y el archivo debe tener un tamaño inferior a 20 KB. Cuando utilice logotipos personalizados, recuerde cumplir con las Condiciones del Servicio de Google. Y evite usar el logotipo de Google, el logotipo de Gmail o cualquier otro logotipo de Google. Para obtener más información, consulta Políticas de logotipos y páginas de destino. |
| sosoWhitelist | Una ssoWhitelist es una dirección IP de máscara de red en formato de enrutamiento entre dominios sin clases (CIDR). |
| Otros tipos de límites | Limitaciones y lineamientos |
|---|---|
| Estado de verificación del registro MX | El estado de verificación predeterminado de los registros MX es "falso", lo que significa que el sistema de Google no verificó la configuración de los registros MX o que los registros MX no están configurados para apuntar a los sistemas de Google. Si actualizaste tus registros y el estado de la verificación sigue siendo falso, puede significar que las actualizaciones de tu registro MX no se propagaron o que el registro está mal escrito. Para la propagación, te recomendamos que esperes la cantidad de tiempo definida por el valor de tiempo de actividad (TTL) del registro MX y vuelvas a intentarlo. |
| Códigos de país | Si no se personalizó el nombre de la organización, el valor predeterminado será tu nombre de dominio principal. Para obtener información sobre los caracteres del nombre de la organización, consulta Uso de caracteres. |
Propiedad creationTime, representación numérica de las fechas y la hora |
Consulte la ISO 8601 sobre la representación numérica de las fechas y la hora. |
| Etiquetas de codificación de idioma | Consulta las etiquetas de idioma RFC 3066 que se aceptan en Google Mail. |
| Nombre de la organización | Si no se personalizó el nombre de la organización, el valor predeterminado será tu nombre de dominio principal. Para obtener información sobre los caracteres del nombre de la organización, consulta Uso de caracteres. |