En este documento, se describen los límites y las cuotas de la solicitud de las APIs de Management y de Reporting.
Millones de sitios utilizan Google Analytics. Establecemos límites y cuotas a las solicitudes a la API para proteger el sistema de recibir más datos de los que puede manejar y para garantizar una distribución equitativa de los recursos del sistema. Los límites y las cuotas están sujetos a cambios.
En este video, se analizan las prácticas recomendadas para administrar las cuotas de solicitudes a la API de Google Analytics.
Límites de cuota generales
Las siguientes cuotas se aplican a la API de Management, la API de Core Reporting v3, la API de MCF Reporting, la API de metadatos, la API de User Deletion y la API de informes en tiempo real:
- 50,000 solicitudes por proyecto al día, que se pueden aumentar
- 10 consultas por segundo (QPS) por dirección IP.
- En la Consola de APIs, existe una cuota similar denominada Solicitudes cada 100 segundos por usuario. De forma predeterminada, se establece en 100 solicitudes cada 100 segundos por usuario y se puede ajustar a un valor máximo de 1,000. Sin embargo, la cantidad de solicitudes a la API está restringida a un máximo de 10 solicitudes por segundo por usuario.
- Si tu aplicación realiza todas las solicitudes a la API desde una sola dirección IP (es decir, en nombre de tus usuarios), usa el parámetro
userIPoquotaUsercon cada solicitud para obtener la cuota completa de QPS para cada usuario. Consulta el resumen de los parámetros de consulta estándar para obtener más detalles.
APIs de informes
Las siguientes cuotas se aplican a todas las APIs de Reporting, incluidas la API de Core Reporting v3, la API de Analytics Reporting v4, la API de Real Time v3 y la API de Multi-channel Funnel v3:
- 10,000 solicitudes por vista (perfil) al día (no se pueden aumentar)
- 10 solicitudes simultáneas por vista (perfil) (no se puede aumentar)
Este comportamiento proporciona un enfoque más detallado y a prueba de fallas para administrar las cuotas, de modo que las llamadas frecuentes que usan la API de Analytics Real Time Reporting no bloquearían accidentalmente todas las demás llamadas a la API de Analytics durante el resto del día para una vista individual (perfil).
Errores de solicitud a las APIs de informes
Si tu solicitud a la API de Reporting falla con un error de servidor, obtendrás un código de respuesta 500 o 503. Puedes volver a enviar la solicitud. Sin embargo, no la vuelvas a enviar más de una vez si falla repetidamente. Google Analytics permite lo siguiente:
- 10 solicitudes con errores de servidor por proyecto y por vista (perfil) por hora
- 50 solicitudes con errores de servidor por proyecto y por vista (perfil) por día
Si la cantidad de solicitudes fallidas supera estas cuotas, verás el siguiente error:
Quota Error: The number of recent reporting API requests failing by server error is too high. You are temporarily blocked from the reporting API for at least an hour. Please send fewer server errors in the future to avoid being blocked.
Para reducir las posibilidades de que se produzca un error en el servidor de solicitudes, reduce el período, disminuye el número de dimensiones o las métricas de la solicitud para simplificarla.
No vuelvas a enviar una solicitud con errores de forma continua. En su lugar, implementa una retirada exponencial para volver a enviarla.
Las cuotas de tasa de errores del servidor se aplican a períodos progresivos para cada una de las cuotas por hora y por día. Una hora después del primer error de servidor de un proyecto y una vista, se restablece la cuota. Si un par de proyectos y vistas envía 10 errores de servidor en una hora, el par de vistas y proyecto se bloquea en la API hasta la hora posterior a que transcurra el primer error de servidor.
Por ejemplo, si un par de proyectos y vistas no envió un error de servidor en las últimas 24 horas, el proyecto y la vista usarán 0 de su cuota de 50. Supongamos que este proyecto y esta vista ahora envían un error de servidor a las 6:12 a.m. Si este proyecto y la vista envían 49 errores de servidor adicionales antes de las 6:12 a.m. del día siguiente, este proyecto y la vista se bloquearán hasta las 6:12 a.m. del día siguiente. A las 6:12 a.m. del día siguiente, la cuota de tasa de errores del servidor se restablecerá por completo para este proyecto y esta vista.
Se superaron los límites de cuota
Si se supera la cuota para solicitar una API de Google Analytics, esta muestra un código de error 403 o 429 y un mensaje que indica que la cuenta superó la cuota. Consulta las Condiciones del Servicio para obtener más información.
Solicita cuota adicional
Solo puedes solicitar que se aumente lo siguiente:
- La cantidad de solicitudes de lectura diarias por proyecto (50,000 valor predeterminado)
- La cantidad de solicitudes de escritura diarias por proyecto (50 predeterminadas)
Si deseas ver o cambiar los límites de uso de tu proyecto, o solicitar un aumento de la cuota, haz lo siguiente:
- Si no tienes una cuenta de facturación para tu proyecto, crea una.
- Visita la página de API habilitadas de la biblioteca de API en la Consola de APIs y selecciona una API de la lista.
- Si deseas consultar y cambiar la configuración de cuotas, selecciona la opción Cuotas. Para consultar las estadísticas de uso, selecciona la opción Uso.
Para solicitar un aumento del importe máximo de la cuota, usa el formulario de solicitud de cuota de la API de Analytics. Asegúrate de revisar la información y seguir las instrucciones del formulario de solicitud de cuota antes de enviar la solicitud. Para la versión 4 de la API de Reporting, el nombre de la API en la Consola de APIs de Google es API de Google Analytics Reporting. Todas las demás APIs v3 (p.ej., la versión 3 de la API de Management, la API de Core Reporting v3, la API de Informes en tiempo real v3 y la API de User Deletion v3) se enumeran en la API de Analytics en la Consola de API de Google.
Si deseas obtener más información sobre la administración de cuotas y cómo ajustar tu aplicación para el uso de la cuota, consulta Supervisa las APIs y limita el uso.