Empezar a usar la API del Centro de Datos de Anuncios

En esta guía se explica cómo empezar a escribir aplicaciones que usan la API REST del Centro de Datos de Anuncios para interactuar con dicha plataforma. Esta API te permite ver los clientes del Centro de Datos de Anuncios asociados a tu cuenta de Google, así como crear y ejecutar consultas.

Configuración

Antes de usar la API del Centro de Datos de Anuncios, debes completar algunos pasos:

  1. Asegúrate de que el usuario que habilita la API tenga el permiso serviceusage.services.enable en el proyecto de Google Cloud.
    1. El usuario con el permiso serviceusage.services.enable también debe incluirse en la lista de permitidos para acceder a la API. Ponte en contacto con el equipo de Asistencia para añadir usuarios a la lista de permitidos.
  2. Habilita la API del Centro de Datos de Anuncios en el proyecto de Google Cloud en el que se hayan creado las credenciales de cliente o la cuenta de servicio. Para habilitar la API del Centro de Datos de Anuncios en un proyecto mediante la consola:
    1. Ve a la biblioteca de la API de la consola de Cloud.
    2. En la lista de proyectos, selecciona el que quieras usar.
    3. Busca la API del Centro de Datos de Anuncios.
    4. En la página de la API, haz clic en HABILITAR.
  3. Gestiona los permisos:
    1. La dirección de correo o la cuenta de servicio que usas para crear las credenciales deben añadirse al Centro de Datos de Anuncios con los permisos adecuados. En el caso de las cuentas de servicio, es la dirección de correo de la propia cuenta. En el caso de OAuth, es la dirección de correo del usuario. De este modo, la cuenta de servicio o la cuenta del usuario final tendrán permiso para ejecutar consultas en el Centro de Datos de Anuncios.
  4. (Recomendado) Instala una biblioteca de cliente de las APIs de Google:
    1. Las bibliotecas de cliente de las APIs de Google están disponibles en varios lenguajes conocidos y te permiten trabajar con muchas de las APIs de Google. Aunque no es obligatorio, las bibliotecas de cliente reducen la cantidad de código que tienes que escribir y facilitan la autenticación.
Biblioteca de cliente Ejemplos del Centro de Datos de Anuncios
Biblioteca de cliente de APIs de Google para Java Java
Biblioteca de cliente de APIs de Google para Python

Autenticar y autorizar

La API del Centro de Datos de Anuncios puede acceder a tu cuenta de cliente del Centro de Datos de Anuncios y modificar sus datos, por lo que debe verificar que eres un usuario autorizado. Por este motivo, antes de empezar a interactuar con la API del Centro de Datos de Anuncios, debes completar los pasos de un flujo de autorización. El flujo de autorización te proporciona los permisos necesarios para interactuar con la API. Puedes autenticarte mediante OAuth 2.0 o una cuenta de servicio.

Configuración de la cuenta de servicio

  1. Ve a la Consola de APIs de Google y desplázate hasta tu proyecto de administrador.
  2. Comprueba que la API del Centro de Datos de Anuncios esté habilitada para tu proyecto en la sección APIs y servicios.
    1. Si no lo está, haz clic en + Habilitar APIs y servicios y habilita la API del Centro de Datos de Anuncios.
  3. En el menú de navegación de la izquierda, haz clic en IAM y administración > Cuentas de servicio.
    1. Si aún no has creado ninguna cuenta de servicio, crea una.
  4. Haz clic en el menú de 3 puntos () de la columna "Acciones" y, a continuación, en Administrar claves.
    1. Haz clic en Añadir clave > Crear clave.
    2. Comprueba que se haya seleccionado "JSON" y haz clic en Crear.
  5. Añade la dirección de correo de la cuenta de servicio como usuario a tu cuenta del Centro de Datos de Anuncios.

Enviar una solicitud de ejemplo

#!/usr/bin/env python3

"""This sample shows how to retrieve all accounts associated with the user.
"""
import json
from google.oauth2.service_account import Credentials
from googleapiclient.discovery import build

SCOPES = ['https://www.googleapis.com/auth/adsdatahub']
DISCOVERY_URL = 'https://adsdatahub.googleapis.com/$discovery/rest?version=v1'
creds = Credentials.from_service_account_file(
    'service-account.json').with_scopes(SCOPES)
developer_key = 'YOUR_DEVELOPER_KEY'  # Replace with your developer key.
service = build('AdsDataHub', 'v1', credentials=creds,
                developerKey=developer_key, discoveryServiceUrl=DISCOVERY_URL)

# Replace with your customer ID.
customer_name = input('Customer name (e.g. "customers/123"): ').strip()
queries = service.customers().analysisQueries().list(
    parent=customer_name).execute()
print(json.dumps(queries, sort_keys=True, indent=4))

Pasos siguientes

  • Consulta el artículo Consultas de muestra en el Centro de Datos de Anuncios para ver ejemplos del tipo de consultas que puedes crear y ejecutar con la API REST del Centro de Datos de Anuncios.
  • Amplía los ejemplos para familiarizarte con la API y personalízala según tus necesidades. Después, intenta:
  • Si tienes preguntas o comentarios sobre la API, ponte en contacto con el equipo de Asistencia del CDA.