API de administración: guía para programadores de enlaces de AdWords

En este documento se describe cómo usar la API de administración para administrar el enlace de las cuentas de AdWords y de Analytics de un usuario autorizado.

Introducción

Los enlaces de AdWords de la API de administración te permiten obtener, enumerar, crear, actualizar y suprimir enlaces entre las cuentas de Google AdWords y las propiedades de Google Analytics, así como administrar las vistas (perfiles) que se completarán con datos de AdWords.

Para obtener más información sobre cómo funciona el enlace de AdWords y sus ventajas, consulta Enlazar Google Analytics y AdWords (Centro de ayuda de AdWords) y Enlazar y desvincular Analytics y AdWords (Centro de ayuda de Analytics).

Antes de empezar

A todas las API de Google Analytics se accede de un modo similar. Antes de empezar a usar la API de administración, debes realizar las siguientes acciones:

  • Consultar 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.
  • Consultar la Guía de referencia para obtener información sobre la interfaz de la API y el acceso a los datos 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, sabrás cómo acceder a las API de Google Analytics para realizar tareas del mundo real.

Casos prácticos

El enlace de AdWords en la API de administración se puede utilizar para automatizar los siguientes casos:

Enumerar todos los enlaces de Analytics y AdWords de una propiedad

Para enumerar todos los enlaces de Analytics y AdWords activos de una propiedad.

  1. Utiliza la API de administración o la interfaz web para recuperar el ID de cuenta y el ID de propiedad.
  2. Ejecuta el método list del recurso entityAdWordsLinks.

Consulta en la referencia de la API la información del método update del recurso entityAdWordsLinks.

Crear un nuevo enlace entre Analytics y AdWords

Para crear un enlace entre una propiedad de Analytics y una cuenta de AdWords:

  1. Utiliza la API de AdWords o la interfaz web para recuperar el ID de cliente.
  2. Utiliza la API de administración de Google Analytics o la interfaz web para recuperar el ID de la cuenta y de propiedad para enlazar la cuenta de AdWords.
  3. Crea el enlace entre AdWords y Analytics ejecutando el método insert del recurso entityAdWordsLinks.

Consulta en la referencia de la API la información del método insert del recurso entityAdWordsLinks.

Para quitar un enlace entre una propiedad de Analytics y una cuenta de AdWords:

  1. Utiliza la API de administración de Google Analytics o la interfaz web para recuperar el ID de la cuenta y de propiedad con el enlace que quieres quitar.
  2. Utiliza la API de administración para recuperar el ID del enlace de AdWords.
  3. Quita el enlace ejecutando el método delete del recurso entityAdWordsLinks.

Consulta en la referencia de la API la información del método delete del recurso entityAdWordsLinks.

Agregar una vista (perfil) a un enlace de Analytics y AdWords

Para habilitar los datos de AdWords en los informes de una vista (perfil):

  1. Utiliza la API de administración de Google Analytics o la interfaz web para recuperar el ID de la cuenta, de la propiedad y de la vista (perfil).
  2. Utiliza la API de administración para recuperar el ID del enlace de AdWords al que se enlazará la vista (perfil).
  3. Agrega la vista (perfil) ejecutando el método patch del recurso entityAdWordsLinks.

Consulta en la referencia de la API la información del método patch del recurso entityAdWordsLinks.

Quitar una vista (perfil) de un enlace de Analytics y AdWords

Para desvincular y quitar los datos de AdWords de los informes de una vista (perfil):

  1. Utiliza la API de administración de Google Analytics o la interfaz web para recuperar el ID de la cuenta, de la propiedad y de la vista (perfil).
  2. Utiliza la API de administración para recuperar el ID del enlace de AdWords al que está enlazada la vista (perfil) que quieres quitar.
  3. Ejecuta el método get del recurso entityAdWordsLinks y recupera la lista de ID de perfil del enlace de AdWords.
  4. Quita el ID de perfil de la lista recuperada en el paso 3.
  5. Quita la vista (perfil) ejecutando el método patch del recurso entityAdWordsLinks con la lista del paso 4.

Consulta en la referencia de la API la información del método get del recurso entityAdWordsLinks.

Ejemplos de código

El recurso Enlaces de AdWords permite que un usuario autorizado enumere, obtenga, actualice, parchee e inserte enlaces de AdWords. 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 Enlaces de AdWords, consulta las siguientes referencias de métodos:

Administrar los enlaces de AdWords

  • list: enumera los enlaces de AdWords a los que tiene acceso el usuario.
  • get: obtiene un enlace de AdWords al que tiene acceso el usuario.
  • insert: crea un nuevo enlace de AdWords.
  • patch: parchea un enlace de AdWords.
  • update: actualiza un enlace de AdWords.
  • delete: suprime un enlace de AdWords.