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 para poder usar la cuota QPS de cada usuario. Consulta los detalles en el resumen de los parámetros de consulta estándar.

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):

  • 50 solicitudes de escritura por proyecto al día; se puede incrementar
  • 1,5 consultas por segundo (QPS) por ID de cuenta

Errores de las solicitudes de escritura

Si la solicitud de escritura no se acepta 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 tiempo de espera 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 cuentan respecto a los límites de 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 envían a la API para crear informes sin muestrear cuentan respecto a los límites de la cuota general de solicitudes de escritura.
  • En la API se utiliza el mismo sistema de tokens por propiedad y por día que se usa en 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 intenta 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 como máximo 100 cuentas de Analytics. Si añades un usuario que tiene 100 cuentas de Analytics a otra cuenta, se produce un error.

Las cuotas siguientes se aplican a los lotes de solicitudes de escritura (delete, insert, update) 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 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. En la consola de APIs, ve a la biblioteca de APIs para ver la página de las habilitadas 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.