La API de Google Analytics Management habilita el acceso programático a las cuentas, propiedades y vistas. En este documento, se describe cómo utilizar varios recursos de la API para configurar la configuración de tu cuenta de Google Analytics.
Introducción
Existen dos casos de uso comunes que aborda la API de Management cuando se trata de configurar la configuración de tu cuenta de Google Analytics. La primera es la necesidad de obtener rápidamente un resumen de la cuenta del árbol jerárquico completo de las cuentas, las propiedades y las vistas. El segundo es realizar cambios específicos en la configuración.
Resúmenes de cuentas
El extremo Resúmenes de la cuenta ofrece una manera fácil de enumerar información básica sobre cuentas, propiedades y vistas de Google Analytics para un usuario autorizado con una solicitud única y rápida.
Los resúmenes de la cuenta pueden utilizarse para crear un índice de la jerarquía de la cuenta. Es común 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 sola solicitud a la API, puedes recuperar toda la información relevante para compilar un selector de este tipo. Para ver un ejemplo, consulta el Explorador de consultas y las muestras de código en GitHub.
Consulta la referencia de recursos de los resúmenes de cuentas y la referencia del método de lista para obtener detalles y ejemplos de códigos.
Configuración de la cuenta
A diferencia de los resúmenes de la cuenta, cuando usas el método de lista de los recursos Cuenta, Propiedad y Vista, la API muestra los detalles completos de cada recurso.
Cuentas
Dado que las cuentas de la entidad de nivel superior son importantes, ya que cada solicitud a la API de nivel inferior requiere un ID de cuenta. La API de Management solo permite la operación list en las cuentas. Nota: En la respuesta de la API, se incluye la propiedad childlink, que proporciona la solicitud a la API para todas las propiedades web secundarias.
Propiedades
La entidad de segundo nivel, también llamada propiedades web, es importante porque toda la recopilación de datos ocurre en este nivel. Por ejemplo, cuando agregas el código de seguimiento a un sitio web o una aplicación para dispositivos móviles, debes incluir un ID similar a UA-XXXXX-Y. Este ID se denomina ID de propiedad o ID de seguimiento y distingue en qué datos se almacenan los datos de la cuenta de Google Analytics. Puedes usar la API para crear o actualizar propiedades. Consulta el recurso de propiedad para obtener detalles y ejemplos de código.
Vistas
Dado que se trata del tercer nivel de la jerarquía de la cuenta, las vistas (perfiles) son importantes porque este es el nivel en el que se generan los informes. La API de Core Reporting usa el ID de vista (perfil) como parámetro clave para especificar desde qué vista recuperar datos. Además de estar en el nivel de los informes, muchos otros recursos están vinculados o son elementos secundarios de este recurso, por ejemplo, objetivos, experimentos, informes sin muestrear y vínculos de filtro. Puedes usar la API para crear o actualizar vistas. Consulta el recurso de vistas (perfil) para obtener detalles y ejemplos de código.
Próximos pasos
Después de leer esta guía, sabrás cómo usar la API de Management para recorrer y manipular las distintas entidades de configuración de la cuenta. En la siguiente guía, se explicará cómo usar la API para realizar la administración de usuarios.