Los límites y las cuotas protegen la infraestructura de Google de un proceso automatizado que usa 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 diseñado de forma ineficiente que realiza llamadas a la API innecesarias. Independientemente de la causa, bloquear el tráfico de una fuente específica una vez que alcanza un nivel determinado es necesario para el estado general del sistema de Google Workspace. Esto garantiza que las acciones de un desarrollador no puedan afectar negativamente a la comunidad en general.
En el caso poco probable 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, desglosa 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 ventajas y 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, recomendamos que tu código detecte la excepción y, con un algoritmo de retirada exponencial, espere un breve retraso antes de volver a intentar la llamada con errores. Un ejemplo de la API de Email Settings para un subproceso es esperar 5 segundos y volver a intentar 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, tu aplicación debería 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 con errores. Además, decide un límite de reintentos. Por ejemplo, reintenta una solicitud de 5 a 7 veces con diferentes tiempos de retraso antes de que tu aplicación devuelva 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". |
| 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 del inicio de sesión único basado 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 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. No uses el logotipo de Google, el de Gmail ni ningún otro logotipo de Google. Para obtener más información, consulta las políticas de logotipos y páginas de destino. |
| ssoWhitelist |
Un 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 de los registros MX |
El estado predeterminado de la verificación de registros MX es "false", lo que significa que el sistema de Google no revisó recientemente la configuración de tus registros MX o que estos 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 tus registros 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 no se personalizó el nombre de la organización, 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 la norma 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 no se personalizó el nombre de la organización, 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 la cuota por proyecto
Según el uso que hagas de los recursos de tu proyecto, es posible que desees solicitar un ajuste de cuota. Se considera que las llamadas a la API que realiza una cuenta de servicio usan una sola cuenta. Solicitar un ajuste de cuota no garantiza la aprobación. Las solicitudes de ajuste de cuota que aumentarían 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 tus valores de cuota deban aumentar. Si prevés un aumento considerable en el uso, puedes solicitar ajustes en la cuota de forma proactiva en la página Cuotas y límites del sistema de la consola de Google Cloud.
Para obtener más información, consulta los siguientes recursos: