Límites y cuotas en las solicitudes de API

En este documento se describen los límites y las cuotas que se aplican a las solicitudes de 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 de API, los cuales están sujetos a cambios.

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

Límites de cuotas 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 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 Consultas por usuario por cada 100 segundos. 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 cada segundo por usuario.
    • Si tu aplicación realiza todas las solicitudes de 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 dispongan de la cuota de QPS completa. En el resumen de los parámetros de consulta estándar encontrarás toda la información.

APIs de administración

Google Analytics aplica cuotas a las solicitudes que se realizan a las siguientes APIs de administración:

APIs de escritura

Estas cuotas conciernen a las solicitudes de escritura (insert, update, patch y delete):

  • 500 solicitudes de escritura por proyecto al día; se puede incrementar
  • 1,5 QPS por ID de cuenta

Errores de las solicitudes de escritura

Si la solicitud de escritura no se lleva a cabo y se muestra el código de respuesta 500 o 503, puedes volver a enviar la solicitud. Google Analytics permite enviar:

  • 50 solicitudes de escritura fallidas cada hora

Si intentas enviar más de 50 solicitudes de escritura fallidas por hora, se muestra el error siguiente:

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

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

API de importación de datos

Estas cuotas son específicas del recurso Uploads:

  • Límite de almacenamiento total de importación de datos ampliados (no afecta a los datos de hits enviados desde las API y los SDK de recogida 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 importas 50 MB de datos del 2014-10-10 en una subida y realizas 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.

API de experimentos

Esta cuota afecta solo a los experimentos:

  • 12 experimentos por vista (perfil)

Los experimentos que presentan uno de los estados (statuses) siguientes computan para esta cuota:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Los experimentos que llevan terminados (estado = ENDED) más de un día no computan para esta cuota.

API de informes sin muestrear

Estas cuotas se aplican únicamente a los informes sin muestrear:

  • Las solicitudes que se realizan a la API para crear informes sin muestrear computan para la cuota general de solicitudes de escritura.
  • La API utiliza el mismo sistema de tokens por propiedad y por día que usa la interfaz web para crear informes sin muestrear.
  • El número máximo permitido de informes sin muestrear es de 3500. Cuando se alcanza este límite y se intentan crear más informes sin muestrear con la API, se produce el siguiente error:
    Error creating this entity. You have reached the maximum allowed entities of this type.

API de permisos de usuario

Esta cuota afecta solo a los permisos de usuario:

  • Un usuario puede tener 100 cuentas de Analytics como máximo. Si añades un usuario que tiene 100 cuentas de Analytics a otra cuenta, se producirá un error.

Las cuotas siguientes se aplican a los lotes de solicitudes de escritura (delete, insert, update) de la API de permisos de usuario:

  • 300 solicitudes de escritura de permisos de usuario por cada solicitud por lotes
  • Cada lote de 30 solicitudes de escritura de permisos de usuario cuenta como 1 solicitud de escritura

Superar los límites de cuota

Si se supera la cuota de solicitud de 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 ninguna 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 API de la lista.
  3. Para ver y cambiar la configuración relativa a la cuota, selecciona Quotas (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 de 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) 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 optimizar tu aplicación según el uso de la cuota, consulta el artículo que explica cómo supervisar las API y limitar su uso.