Límites y cuotas en las solicitudes a API

En este documento se describen los límites y las cuotas que se aplican a las solicitudes a las API de informes y las API de administración.

Google Analytics se usa en millones de sitios web. Para evitar que el sistema reciba más datos de los que puede gestionar, así como para garantizar una distribución equitativa de los recursos del sistema, aplicamos algunos límites y cuotas en las solicitudes a APIs, los cuales pueden cambiar.

En este vídeo se ofrecen prácticas recomendadas para gestionar las cuotas de las solicitudes a la API de Google Analytics.

Límites de cuota generales

La API de administración, la versión 3 de la API de informes centrales, la API de informes MCF, la API de metadatos, la API de eliminación de usuarios y la API de informes en tiempo real se rigen por las cuotas que se indican a continuación:

  • 50.000 solicitudes por proyecto al día; se puede incrementar
  • 10 consultas por segundo (QPS) por dirección IP
    • En la consola de APIs hay una cuota similar que se denomina Solicitudes cada 100 segundos por usuario. El valor predeterminado es de 100 solicitudes cada 100 segundos por usuario y se puede ajustar hasta un valor máximo de 1000. Sin embargo, la API solo puede recibir hasta 10 solicitudes por segundo y usuario.
    • Si tu aplicación envía todas las solicitudes a API desde la misma dirección IP (p. ej., en nombre de tus usuarios), utiliza el parámetro userIP o quotaUser en cada solicitud asegurarte de que todos los usuarios tengan toda la cuota de QPS. Consulta los detalles en el resumen de los parámetros de consulta estándar.

APIs de informes

Las cuotas siguientes son aplicables a todas las API de informes como, por ejemplo, la versión 3 de la API de informes centrales, la versión 4 de la API de informes de Analytics, la versión 3 de la API de informes en tiempo real o la versión 3 de la API de informes de embudos multicanal:

  • 10.000 solicitudes por vista (perfil) al día; no se puede incrementar
  • 10 solicitudes simultáneas por vista (perfil); no se puede incrementar

Errores en las solicitudes a las API de informes

Si la solicitud que realizas a una API de informes falla y aparece el código de respuesta 500 o 503, puedes volver a enviarla. Google Analytics permite que se produzcan:

  • 10 solicitudes fallidas por proyecto y perfil cada hora
  • 50 solicitudes fallidas por proyecto y perfil cada día

Si el número de solicitudes fallidas supera estas cuotas, aparecerá el error siguiente:

Quota Error: The number of recent failed writes is too high.

En lugar de seguir enviando una solicitud fallida, implementa un retardo exponencial para volver a enviarla.

Versión 4 de la API de informes de Analytics

Estas cuotas conciernen únicamente a la versión 4 de la API de informes de Analytics:

  • Grupo de cuotas:
    • Solicitudes por proyecto al día: 50.000
    • Solicitudes por vista (perfil) al día: 10.000 (no se puede aumentar)
    • Solicitudes por cada 100 segundos por proyecto: 2000
    • Solicitudes por 100 segundos por usuario y proyecto: 100 (se puede incrementar hasta 1000 en la consola de APIs de Google)
  • Solicitudes de detección:
    • Solicitudes por cada 100 segundos: 17.000

Puedes consultar las cuotas de tus proyectos en la consola de APIs de Google.

Cuotas basadas en los recursos

La versión 4 de la API de informes de Analytics también se rige por la cuota basada en los recursos opcional, que ofrece límites de muestreo más amplios a los clientes de Analytics 360.

Superar los límites de cuota

Si se supera la cuota de solicitud a una API de Google Analytics, esta devuelve el código de error 403 o 429 y un mensaje indicando que la cuenta ha superado la cuota. Consulta las Condiciones de Servicio para obtener más información.

Solicitar cuota adicional

Solo puedes solicitar cuota adicional para incrementar los valores siguientes:

Para ver o cambiar los límites de uso de tu proyecto o para solicitar un aumento de la cuota, debes hacer lo siguiente:

  1. Si todavía no tienes una cuenta de facturación para tu proyecto, crea una.
  2. Visita la página de API habilitadas de la biblioteca de APIs en la consola de API y selecciona una de la lista.
  3. Para ver y cambiar la configuración relativa a la cuota, selecciona Cuotas. Si quieres ver las estadísticas de uso, selecciona Uso.

Para solicitar un aumento de la cuota máxima, usa el formulario de solicitud a cuota de la API de Analytics. Antes de enviar este formulario, no te olvides de consultar la información y de seguir las instrucciones que incluye. En la consola de APIs de Google, el nombre de la versión 4 de la API de informes es API de informes de Google Analytics. Las demás API van por la versión 3 (p. ej., Versión 3 de la API de administración; Versión 3 de la API de informes centrales; Versión 3 de la API de informes en tiempo real; Versión 3 de la API de eliminación de usuarios) y aparecen debajo de API de Analytics en la consola de APIs de Google.

Si quieres obtener más información sobre cómo gestionar las cuotas y ajustar la aplicación para optimizar el uso que se haga de dichas cuotas, consulta de qué modo se supervisan las API y se limita su uso.