Límites y cuotas de la API

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

Descripción general

Google Analytics se usa en millones de sitios web. Para evitar que el sistema reciba más datos de los que puede gestionar, y para garantizar una distribución equitativa de los recursos del sistema, aplicamos algunos límites y cuotas en las solicitudes de API. A continuación se describen las políticas, que están sujetas a cambios.

En este vídeo se ofrecen prácticas recomendadas sobre las cuotas generales de la API de Google Analytics, que se comparten entre las distintas API, así como sobre las cuotas específicas de las API de administración o de informes.

Límites de cuotas generales

Los siguientes límites de cuotas se comparten entre las API de administración, informes centrales (versión 3), informes de embudos multicanal, metadatos e informes en tiempo real.

  • 50.000 solicitudes por proyecto al día; se puede incrementar
  • 10 consultas por segundo (QPS) por IP
    • En la consola de la API hay una cuota similar que se denomina "Request per 100 seconds per user" (Solicitud por 100 segundos por usuario). De forma predeterminada, está configurada en 100 solicitudes por 100 segundos y se puede ajustar hasta un valor máximo de 1000. A pesar de que aparezca como "por 100 segundos", el límite de la API son 10 solicitudes por segundo por usuario como máximo.
    • Si tu aplicación realiza todas las solicitudes de API desde la misma dirección IP (p. ej., en nombre de tus usuarios), te recomendamos que utilices el parámetro userIP o quotaUser en cada solicitud para asegurarte de que cada usuario tenga toda la cuota de QPS. Consulta los detalles en el resumen de los parámetros de consulta estándar.

API de administración

Solicitudes de escritura

Esta cuota se aplica a las solicitudes de escritura (p. ej., insert, update, patch o delete):

Errores de las solicitudes de escritura

Al implementar un retardo exponencial, puedes volver a intentar hacer una solicitud si obtienes errores de tipo 500 o 503. Esta es la cuota que se aplica a las solicitudes de escritura que presentan errores:

  • 50 solicitudes de escritura con errores por hora

Importar datos

Estas cuotas son específicas del recurso Uploads:

  • Límite de almacenamiento total para la importación de datos ampliados (no se aplica a los datos de hits enviados desde las API y los SDK de recopilación de datos).
  • 50 conjuntos de datos por propiedad.
  • 50 operaciones de subida por propiedad al día
  • 1 GB por archivo subido
  • Límites específicos de los datos de costes:
    • 100 MB por fecha (ga:date) y conjunto de datos. Por ejemplo, si subes 50 MB de datos del 2014-10-10 en una subida y realiza otra subida con la misma cantidad de datos del mismo día, habrás alcanzado el límite de 100 MB del 2014-10-10 en ese conjunto de datos.

Experimentos

Esta cuota es específica de la función Experimentos:

  • 12 experimentos por vista (perfil). Los experimentos con el siguiente status se contabilizan en este límite: DRAFT, READY_TO_RUN y RUNNING. Los experimentos que tienen el estado ENDED durante más de un día no se tienen en cuenta en este límite.

Informes sin muestrear

Estas cuotas son específicas de los informes sin muestrear:

  • Las solicitudes para crear informes sin muestrear se incluyen en la cuota general de las solicitudes de escritura.
  • La API utiliza el mismo sistema de token por propiedad, por día que cuando crea un informe sin muestrear a través de la interfaz web.

Permisos de usuario

Esta cuota es específica de los permisos de usuario:

  • 100 cuentas enlazadas por usuario

Estos límites se aplican a los permisos de usuario en las solicitudes de escritura por lotes (delete, insert y update):

  • 300 solicitudes de permisos de usuario por solicitud por lotes
  • 30 solicitudes de permisos de usuario por lotes equivalen a una solicitud de escritura

API de gestión de cuentas

Solicitudes de escritura

Esta cuota se aplica a las solicitudes de escritura (por ejemplo, createAccountTicket) de la API de gestión de cuentas:

  • 50 solicitudes por proyecto al día

API de informes

Estas cuotas se aplican a todas las API de informes como, por ejemplo, la API de informes centrales, la API de informes en tiempo real, la API de informes de embudos multicanal (versión 3) o la API de informes de Analytics (versión 4):

  • 10.000 solicitudes por vista (perfil) al día
  • 10 solicitudes simultáneas por vista (perfil)

Errores en la generación de informes

Esta es la cuota que se aplica a las solicitudes de informes que presentan errores (5XX):

  • 10 solicitudes con errores por proyecto por perfil cada hora
  • 50 solicitudes con errores por proyecto por perfil al día

Superar los límites de cuota

Si se supera la cuota, la API de Google Analytics devuelve un error en las solicitudes adicionales (HTTP status code 403 Forbidden) y muestra un mensaje en el que se indica que la cuenta concreta no tiene suficiente cuota para continuar. Consulta las condiciones del servicio para obtener más información.

Solicitar cuota adicional

Solo puedes solicitar un aumento de cuota en el número de solicitudes de proyecto diarias y en las solicitudes de escritura diarias. Si crees que tu aplicación necesita más cuota diaria, puedes solicitarla siguiendo las instrucciones que se indican a continuación.

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 ninguna cuenta de facturación para tu proyecto, crea una.
  2. Visita la página de API habilitadas de la biblioteca de API en la consola de API y selecciona una API de la lista.
  3. Para ver y cambiar la configuración relativa a la cuota, selecciona Quotas (Cuotas). Para ver las estadísticas de uso, selecciona Usage (Uso).

No te olvides de consultar la información y de seguir las instrucciones que se incluyen en el formulario de solicitud de cuota antes de enviar una solicitud de aumento. El nombre de la versión 4 de la API de informes en Developers Console es API de informes de Analytics (v.4). Las demás API de la versión 3 (p. ej., API de administración, API de informes centrales o API de informes en tiempo real) se agrupan en Developers Console bajo el mismo nombre: API de Analytics.

Para obtener más información sobre la administración de la cuota y el modo de optimizar la aplicación para que use la cuota, consulta la sección Supervisar las API y limitar el uso.