API de administración: guía para programadores de vistas (perfiles)

En este documento se explica cómo usar la API de administración para acceder a los datos de vistas (perfiles).

Introducción

Un recurso de vista (perfil) de Google Analytics está en el tercer nivel de la jerarquía de la cuenta. Cada vista (perfil) tiene un solo recurso Webproperty como su elemento principal en la jerarquía y puede tener una colección de cero o más recursos Objetivo como elementos secundarios.

  • Consulta la descripción general de las entidades en la guía de descripción general de la API de administración para saber cómo se relacionan las vistas (perfiles) con otras entidades de la API de administración.
  • Consulta la guía conceptual Cuentas y vistas (perfiles) para obtener información general sobre las vistas (perfiles).

Una vista (perfil) de Google Analytics es importante porque todos los informes se realizan en este nivel. Al consultar la API de informes centrales, debes especificar un parámetro de ID de tabla en cada consulta de ids para identificar la vista (perfil) a la vista (perfil) a la que se debe acceder para obtener los datos. El parámetro ID de tabla se devuelve en cada recurso de vista (perfil).

Antes de empezar

En esta guía se explica cómo acceder a la API de Google Analytics mediante los siguientes lenguajes de programación:
  • Java
  • Python
  • PHP

  • Consulta la página de bibliotecas de cliente para obtener una lista completa de las bibliotecas de cliente específicas del lenguaje de programación que funcionan con la API de administración.
  • Consulta la Guía de referencia para acceder a la API sin una biblioteca de cliente.

Cada biblioteca de cliente proporciona un solo objeto de servicio Analytics para acceder a todos los datos de la API de administración. Por lo general, para crear el objeto de servicio tienes que realizar los pasos siguientes:

  1. Registrar la aplicación en Google Developers Console.
  2. Autorizar el acceso a los datos de Google Analytics.
  3. Crear un objeto de servicio Analytics.

Si no has completado estos pasos, no sigas y lee el tutorial de presentación de la API de Google Analytics. Con este tutorial recorrerás los pasos iniciales de la creación de una aplicación de la API de Google Analytics. Una vez completado, podrás usar esta guía para realizar tareas del mundo real.

El fragmento de código siguiente continúa desde el paso 3: Crear un objeto de servicio Analytics y contiene una variable para almacenar un objeto de servicio autorizado.

Java

Analytics analytics = // Read Hello Analytics Tutorial for details.

Python

analytics = # Read Hello Analytics Tutorial for details.

PHP

$client = // Read Hello Analytics Tutorial for details.

// Return results as objects.
$client->setUseObjects(true);

$analytics = new apiAnalyticsService($client);

La biblioteca PHP devolverá todos los resultados de la API como una matriz asociativa. Para devolver los objetos reales, se puede llamar al método useObject de cliente, tal como se ha demostrado en el ejemplo anterior.

Después de crear un objeto de servicio Analytics, estarás preparado para realizar solicitudes a la API de administración.

Nota: El mismo objeto de servicio Analytics también se puede usar para acceder a la API de informes centrales.

Usar una cuenta de prueba

Si tienes previsto usar la API de administración para crear o configurar vistas (perfiles), es recomendable que implementes y verifiques tu código con una cuenta de prueba. El uso de una cuenta de este tipo te servirá para que no realices cambios accidentales en una vista (perfil) activa. Después de haber probado y confirmado que tu código funciona del modo previsto con la cuenta de prueba y la vista (perfil), puedes empezar a usar la implementación con las cuentas reales.

Puedes crear una cuenta de prueba en la sección "Administrador" de la interfaz web de Google Analytics.

Límites y comportamiento de las vistas (perfiles)

Los siguientes límites y comportamientos se aplican al recurso Perfil:

  • Existe un límite superior de 25 visualizaciones por propiedad de forma predeterminada. Puedes ponerte en contacto con el gestor de tu cuenta de Google para aumentarlo a 200 propiedades en el caso de las propiedades no premium y a 400 en las propiedades premium. Una vez que una cuenta alcanza el límite, no se pueden crear vistas (perfiles) adicionales mediante la API a menos que se supriman una o varias de las vistas (perfiles) existentes. Además, las vistas (perfiles) que ya existen se pueden actualizar y reutilizar. Consulta Límites y cuotas para obtener información acerca de los límites generales.

Ejemplos de código

La API de administración permite enumerar, obtener, insertar, actualizar, parchear y suprimir las vistas (perfiles) de un usuario autorizado. Para utilizar cualquiera de estos métodos, primero debes crear un objeto de servicio Analytics, tal como se describe en la sección Antes de empezar.

Para ver ejemplos de código que muestran cómo trabajar con el recurso Perfil, consulta las siguientes referencias de métodos:

  • list: enumera las vistas (perfiles) a las que tiene acceso el usuario.
  • get: obtiene una vista (perfil) a la que el usuario tiene acceso.
  • insert: crear una nueva vista (perfil).
  • patch: actualiza una vista (perfil). Este método es compatible con la semántica de parches.
  • update: actualiza una vista (perfil).
  • delete: suprime una vista (perfil).

Aplicación de ejemplo

Consulta en la muestra de referencia de la API de administración un ejemplo funcional de cómo recorrer todos los datos de la API de administración y cómo acceder a ellos.

Java


API de Google Analytics: ejemplo de la biblioteca de cliente Java

Python


API de Google Analytics: ejemplo de la biblioteca de cliente Python

PHP


API de Google Analytics: ejemplo de la biblioteca de cliente PHP