Qué es la API de informes centrales: descripción general

En este documento se proporciona una descripción general de la versión 3.0 de la API de informes centrales de Google Analytics. En la Guía de referencia puedes consultar una referencia detallada de la API.

Introducción

La API de informes centrales de Google Analytics ofrece acceso a la mayoría de los datos de los informes de Google Analytics. Con la API de informes centrales puedes:

  • Crear paneles personalizados para mostrar datos de Google Analytics.
  • Ahorrar tiempo con la automatización de tareas de informes complejas.
  • Integrar los datos de Google Analytics con otras aplicaciones empresariales.

Elegir una versión

Recientemente hemos lanzado una nueva versión de la API de informes centrales.

  • ¿Vas a crear una nueva aplicación? Te recomendamos que uses la última versión 3.0.
  • ¿Usas la versión 2.3 antigua? Consulta en la Guía de migración la información sobre cómo actualizar la aplicación para que use la nueva versión.

Empezar

¿Quieres empezar inmediatamente? Consulta Tutorial: Hello Analytics API.

Cada aplicación que usa la API tendrá que realizar una serie de pasos para registrarse, autorizar al usuario y trabajar con la API. En este tutorial se indica cada paso y, al final, dispondrás de una aplicación funcional que podrás personalizar.

Descripción conceptual

La API de informes centrales devuelve datos de informe que constan de estadísticas derivadas de los datos que se han recopilado mediante el código de seguimiento de Google Analytics. Cada informe está organizado como dimensiones y métricas. La API de informes centrales se utiliza para consultar las dimensiones y las métricas para crear informes personalizados.

Existen tres conceptos fundamentales subyacentes a la API de informes centrales:

  1. Cómo se relacionan los informes con los usuarios y las vistas (perfiles).
  2. La estructura de un informe y el modo de crear consultas.
  3. Trabajar con la respuesta de la API.

Informes, usuarios y vistas (perfiles)

Para solicitar los datos de informe de un usuario, tu aplicación debe identificar a dicho usuario y especificar una vista (perfil) de la que se extraerán los datos. Un usuario se identifica obteniendo las credenciales de autorización y enviándolas en cada solicitud de API. Una vista (perfil) forma parte de la jerarquía de configuración de Google Analytics y se identifica mediante un ID de vista (perfil).

Hay dos maneras de averiguar el ID de vista (perfil).

  • La aplicación puede usar la API de administración para recorrer la jerarquía de configuración y obtener un ID de vista (perfil)
  • En la URL de cada informe en Google Analytics.
  • En la barra de menú de Google Analytics, haz clic en Administrar. Selecciona la cuenta y la propiedad a las que pertenece la vista. En la columna VER, haz clic en Ver configuración para obtener el ID de vista.

Consultar dimensiones y métricas

La API se consulta para obtener los datos de informe de Google Analytics, que constan de dimensiones y métricas. Las métricas son las mediciones individuales de la actividad de un usuario en tu propiedad, como las sesiones y las páginas vistas. Las dimensiones desglosan las métricas en algunos criterios comunes, como el país o el navegador. Al crear una consulta, se especifican las dimensiones y las métricas que se desean en los datos del informe.

Utiliza la Guía de referencia de dimensiones y métricas interactiva para explorar todas las dimensiones y métricas que se exponen a través de la API. Asimismo, consulta la Guía de referencia de la API de informes centrales para saber cómo especificar las dimensiones y las métricas en una consulta de la API.

Trabajar con informes

Los datos que devuelve la API se pueden considerar como una tabla con un encabezado y una lista de filas. Cada respuesta de la API consta de un encabezado que describe el nombre y el tipo de datos de cada columna. La respuesta también contiene una lista de filas y cada una de ellas es una lista de celdas con datos en el mismo orden que los encabezados. Puedes usar la información del encabezado para determinar el tipo de dato de cada celda.

Consulta la Guía de referencia de la API de informes centrales para obtener más información sobre la respuesta de la API.

Volver al principio

Políticas de cuota y de desactivación

La API de Google Analytics gestiona millones de operaciones. Para evitar que el sistema reciba más operaciones de las que pueda gestionar, y para garantizar una distribución equitativa de los recursos del sistema, es necesario emplear un sistema de cuotas. Consulta los límites específicos en la guía Límites y cuota.

Para obtener información sobre cómo se gestionan los cambios en las columnas de la API de informes centrales (es decir, las dimensiones y las métricas), consulta la política de desactivación de datos. Para obtener información sobre cómo se puede usar la API de metadatos para comprobar las columnas retiradas, consulta la Guía para programadores de la API de metadatos.

Pasos siguientes

Ahora que conoces el funcionamiento de la API, te ofrecemos una serie de recursos que te ayudarán a empezar a trabajar con ella:

  • Consulta la Guía para desarrolladores para obtener información sobre cómo trabajar con la API.
  • Utiliza la herramienta interactiva Explorador de consultas para crear visualmente las consultas y ver la respuesta a través de la API.
  • En el artículo Consultas comunes se enumeran algunas de las consultas más habituales sobre la API de informes centrales.
  • Consulta en la referencia Dimensiones y métricas una lista con todos los datos disponibles a través de la API.
  • Consulta en la página Bibliotecas y muestras la lista de todas las bibliotecas de cliente disponibles que se pueden usar con esta API.

Volver al principio