Administración de cuentas

La API de Google Analytics Management permite 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 tu cuenta de Google Analytics.

Introducción

Existen dos casos de uso comunes que aborda la API de Management cuando se trata de configurar 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 consiste en realizar cambios específicos en la configuración.

Resúmenes de la cuenta

El extremo Resúmenes de la cuenta proporciona una manera fácil de enumerar información sencilla sobre las cuentas, propiedades y vistas de Google Analytics para un usuario autorizado con una solicitud única y rápida.

Los resúmenes de la cuenta se pueden utilizar 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, revisa el Explorador de consultas y las muestras de código en GitHub.

Para obtener detalles y ejemplos de códigos, consulta la referencia de recursos de los Resúmenes de la cuenta y la referencia de métodos para listas.

Configuración de la cuenta

A diferencia de los resúmenes de la cuenta cuando usas el método de lista de los recursos Account, Property y View, la API muestra detalles completos de cada recurso.

Cuentas

Como la entidad de nivel superior, las cuentas son importantes porque cada solicitud a la API de nivel inferior requiere un ID de la cuenta. La API de Management solo permite la operación list en las cuentas. Algo importante en la respuesta de la API es 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 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é lugar 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 son el 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 un parámetro clave para especificar desde qué vista recuperar datos. Además de ser a nivel del informe, muchos otros recursos están vinculados o son elementos secundarios de este, 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 desviar y manipular las distintas entidades de configuración de la cuenta. En la siguiente guía, se explica cómo usar la API para realizar la administración de usuarios.