Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa la API de Admin Settings de forma 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, una vez que alcanza cierto nivel, para mantener el buen estado general del sistema de Google Workspace. Esto garantiza que las acciones de un desarrollador no puedan afectar negativamente a la comunidad más grande.
En el improbable caso de que falle tu solicitud a la API, recibirás una respuesta con un 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 la API se excedieron. Estas respuestas permiten que tu aplicación personalizada detecte estos errores y tome las medidas adecuadas.
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 desventajas y no es útil para todas las situaciones de la API. Si la cantidad de solicitudes es demasiado alta, se producirán errores de cuota.
Para todos los errores basados en el tiempo (un máximo de N elementos durante 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 volver a intentar la llamada fallida. Un ejemplo de la API de Email Settings para un subproceso es esperar 5 segundos y volver a intentar la llamada fallida. Si la solicitud se realiza correctamente, repite este patrón para los demás subprocesos. Si la segunda solicitud no se realiza correctamente, tu aplicación debe reducir la frecuencia de la solicitud hasta que una llamada se realice correctamente. Por ejemplo, aumenta el retraso inicial de 5 segundos a 10 segundos y vuelve a intentar la llamada fallida. Además, decide un límite de reintentos. Por ejemplo, vuelve a intentar una solicitud de 5 a 7 veces con diferentes tiempos de retraso antes de que tu aplicación muestre un error al usuario.
| Categorías de cuotas de la API | Cuotas |
|---|---|
| Tokens de autenticación de ClientLogin | Válido durante 24 horas. El error es "401 token expired". |
| Generación de claves públicas y privadas |
Con tu proveedor de identidad, genera un conjunto de claves públicas y privadas claves con los algoritmos 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 basado en SAML, consulta Cómo generar claves y certificados para el servicio de inicio de sesión único de Google Workspace. |
| Logotipo |
El archivo de imagen del logotipo de una cuenta puede estar en formato JPEG, PNG o GIF. El tamaño recomendado es de 143 x 59 píxeles, y el archivo debe ser inferior a 20 KB. Cuando uses logotipos personalizados, recuerda cumplir con las Condiciones del Servicio de Google Terms of Service. Además, evita usar el logotipo de Google, el logotipo de Gmail o cualquier otro logotipo de Google. Para obtener más información, consulta las políticas de logotipos y páginas de destino. |
| ssoWhitelist |
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 del registro MX predeterminado es `false`, lo que significa que el sistema de Google no verificó recientemente la configuración de tu registro MX o que tus registros MX no se configuraron para que apunten a los sistemas de Google. Si actualizaste tus registros y el estado de verificación sigue siendo falso, puede significar que las actualizaciones de tu registro MX no se propagaron o que hay un error tipográfico en el registro. 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 el nombre de la organización no se personalizó, el valor predeterminado es el nombre de tu 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 fechas y horas |
Consulta ISO 8601, representación numérica de fechas y horas. |
| Etiquetas de codificación de idioma |
Consulta las etiquetas de idioma RFC 3066 que acepta Google Mail. |
| Nombre de la organización |
Si el nombre de la organización no se personalizó, el valor predeterminado es el nombre de tu dominio principal. Para obtener información sobre los caracteres del nombre de la organización, consulta Uso de caracteres. |
Solicita un aumento de cuota por proyecto
Según el uso que hagas de los recursos de tu proyecto, es posible que desees solicitar un ajuste de cuota Las llamadas a la API de una cuenta de servicio se consideran como si usaran una sola cuenta. Solicitar una cuota ajustada no garantiza la aprobación. Las solicitudes de ajuste de cuota que aumenten significativamente el valor de la cuota pueden tardar más en aprobarse.
No todos los proyectos tienen las mismas cuotas. A medida que tu uso de Google Cloud aumenta con el tiempo, es posible que debas aumentar los valores de tus cuotas. Si prevés un aumento considerable en el uso, puedes solicitar ajustes en la cuota de forma proactiva en la página Cuotas de la consola de Google Cloud.
Para obtener más información, consulta los siguientes recursos:
- Acerca de los ajustes de cuota
- Consulta el uso y los límites de cuota actuales
- Solicita un límite de cuota más alto