Límites y cuotas de las solicitudes a la API

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 userIP o quotaUser con 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 administración

Google Analytics aplica cuotas a las solicitudes a estas APIs de Management:

API de escritura

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

  • 50 solicitudes de escritura por proyecto al día, que pueden aumentarse
  • 1.5 consultas por segundo (QPS) por ID de cuenta

Errores de solicitud de escritura

Si tu solicitud de escritura falla y recibes un código de respuesta 500 o 503, puedes volver a enviarla. Google Analytics permite lo siguiente:

  • 50 solicitudes de escritura con errores por hora

Si intentas enviar más de 50 solicitudes de escritura con errores por hora, verás el siguiente error:

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

En lugar de volver a enviar una solicitud de escritura con errores de forma continua, implementa una retirada exponencial para volver a enviarla.

API de Data Import

Estas cuotas son específicas del recurso Uploads:

  • Límites de almacenamiento de la Importación de datos extendidas desde el principio (no se aplican a los datos de hits enviados desde las APIs y los SDKs de Recopilación):
  • 50 conjuntos de datos por propiedad
  • 50 operaciones de carga por propiedad al día
  • 1 GB por archivo subido
  • Límites específicos de los datos de costos:
    • 100 MB por fecha (ga:date) por conjunto de datos Por ejemplo, si importas 50 MB de datos de 2014-10-10 en una carga y 50 MB de datos de 2014-10-10 en una segunda carga, habrás alcanzado el límite de 100 MB de 2014-10-10 para ese conjunto de datos.

API de Experiments

Esta cuota se aplica solo a los Experimentos:

  • 12 experimentos por vista (perfil)

Los experimentos con uno de los siguientes elementos statuses se tienen en cuenta para esta cuota:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Los experimentos finalizados (estado = ENDED) durante más de un día no se contabilizan para esta cuota.

API de informes sin muestrear

Estas cuotas solo se aplican a los informes sin muestrear:

  • Las solicitudes a la API para crear informes sin muestrear se descuentan de la cuota general de Solicitudes de escritura.
  • La API usa el mismo sistema de tokens por propiedad y por día que la interfaz web usa para crear informes sin muestrear.
  • La cantidad máxima permitida de informes sin muestrear es de 3,500. Cuando se alcanza este límite, si intentas 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 User Permission

Esta cuota se aplica únicamente a los Permisos del usuario:

  • Un usuario puede tener 100 cuentas de Analytics como máximo. Agregar un usuario que tiene 100 cuentas de Analytics a una cuenta nueva genera un error.

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

  • 300 solicitudes de escritura de permisos del usuario por solicitud por lotes
  • 30 solicitudes de escritura de permisos del usuario en lotes se cuentan como 1 solicitud de escritura.

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:

Si deseas ver o cambiar los límites de uso de tu proyecto, o solicitar un aumento de la cuota, haz lo siguiente:

  1. Si no tienes una 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 APIs y selecciona una API de la lista.
  3. 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.