Administración de cuentas

La API de administración de Google Analytics permite el acceso programático a las cuentas, propiedades y vistas. En este documento se explica cómo configurar la cuenta de Google Analytics con los distintos recursos de la API.

Introducción

La API de administración está destinada a dos casos comunes a la hora de configurar tu cuenta de Google Analytics. El primero es la necesidad de obtener rápidamente un resumen de cuentas del árbol jerárquico completo de las cuentas, propiedades y vistas. El segundo es realizar cambios de configuración específicos.

Resúmenes de cuentas

El extremo Resúmenes de cuenta permite mostrar de forma sencilla información ligera sobre las cuentas, propiedades y vistas de Google Analytics de un usuario autorizado mediante una solicitud única y rápida.

Los resúmenes de cuentas se pueden utilizar para un índice de la jerarquía de cuentas. Es habitual que las aplicaciones que se integran con Google Analytics proporcionen una interfaz para que los usuarios seleccionen una cuenta, una propiedad y una vista. Con una única solicitud a la API, puedes recuperar toda la información relevante para crear dicho selector. Si quieres ver un ejemplo, consulta el Explorador de consultas y los ejemplos de código en Github.

Si quieres obtener más información y ejemplos de código sobre los Resúmenes de cuentas, consulta la referencia de recursos y la referencia del método list.

Configuración de cuenta

A diferencia de los resúmenes de cuentas, al usar el método list de los recursos Account, Property y View, la API devuelve información completa de cada recurso.

Cuentas

La importancia de las cuentas, como entidad de nivel superior, reside en que todas las solicitudes de API de nivel inferior requieren un ID de cuenta. La API de administración solo permite el funcionamiento de list en las cuentas. Hay que destacar que en la respuesta de la API se encuentra la propiedad childlink, que ofrece a la solicitud de la API todas las propiedades web.

Propiedades

La importancia de la entidad de segundo nivel, también llamada propiedades web, reside en que en ella se recogen los datos. Por ejemplo, al agregar el código de seguimiento a un sitio web o una aplicación móvil, debes incluir un ID de tipo UA-XXXXX-Y. Este ID se denomina ID de propiedad o ID de seguimiento, e indica la cuenta en la que se han almacenado los datos. Puedes utilizar la API para crear o actualizar las propiedades. Para obtener más información y códigos de ejemplo, consulta el recurso de propiedades.

Vistas

La importancia de las vistas (perfiles), como entidad de tercer nivel en la jerarquía de cuentas, reside en que en ellas se realizan los informes. La API de informes centrales utiliza el ID de vista (perfil) como parámetro clave para especificar la vista desde la que se van a recuperar los datos. Además de ser el nivel de los informes, muchos otros recursos están enlazados con este recurso o son secundarios de él, por ejemplo, los objetivos, los experimentos, los informes sin muestrear y los enlaces de filtros. Puedes utilizar la API para crear o actualizar vistas. Si deseas obtener más información y ejemplos de código, consulta el recurso de vistas (perfiles).

Pasos siguientes

Tras leer esta guía ya debes saber utilizar bien la API de administración para tratar y manipular las diversas entidades de configuración de cuenta. En la siguiente guía se explica cómo administrar a los usuarios con la API.