Descripción general

Puedes crear y administrar segmentos de datos con la API de Authorized Buyers Marketplace, que expone un recurso curators.dataSegments. Esta es una API de REST con bibliotecas cliente generadas que puedes usar para tu integración.

Configura la autenticación

Las APIs de Google usan el protocolo OAuth 2.0 para la autenticación y la autorización. A continuación, te indicamos cómo configurar una cuenta de servicio para acceder a la API de Marketplace.

  1. Si aún no lo hiciste, crea un proyecto de Google Cloud que aloje las credenciales que se usan para acceder a la API.
  2. Ve a la página de APIs habilitadas de la consola de Google Cloud. Selecciona el proyecto que creaste anteriormente.

  3. Verás una lista de las APIs y los servicios habilitados. Para acceder a la API de Marketplace, debes habilitarla. Si la API de Marketplace no está habilitada, haz clic en +Habilitar APIs y servicios y sigue las instrucciones que se indican a continuación:

    1. Se te redireccionará a una página con un cuadro de búsqueda. Busca la API de Authorized Buyers Marketplace.
    2. Selecciona API de Authorized Buyers Marketplace en la página de resultados.
    3. Haz clic en Habilitar.
  4. En el menú de navegación, selecciona Credenciales.
  5. Haz clic en + Crear credenciales y, en el menú desplegable resultante, selecciona Cuenta de servicio.
  6. Ingresa un Nombre para la cuenta de servicio. El ID de cuenta de servicio se crea automáticamente cuando se crea la cuenta. Toma nota de este valor, ya que lo necesitarás más adelante en el paso 14. De manera opcional, ingresa una Descripción. Haz clic en Crear y continuar.
  7. De manera opcional, configura los permisos para la cuenta de servicio y haz clic en Continuar.
  8. De manera opcional, configura los usuarios o grupos que pueden realizar acciones como la cuenta de servicio y haz clic en Listo.
  9. Tu nueva cuenta de servicio aparece en Cuentas de servicio. Busca y haz clic en el ID de la cuenta de servicio que acabas de crear.
  10. Haz clic en la pestaña Claves.
  11. En el menú desplegable Agregar clave, selecciona Crear clave nueva.
  12. Selecciona JSON como el Tipo de clave y haz clic en Crear.
  13. Descarga la clave en tu directorio de trabajo. Para obtener más información sobre cómo almacenar tu clave de forma segura, consulta Administra las claves de cuentas de servicio. Tu aplicación usa la clave para realizar llamadas a la API.
  14. Comparte el ID de la cuenta de servicio con tu administrador técnico de cuentas para vincular la cuenta de servicio con tu cuenta.

Permisos de la API

Cuando sigas el flujo de OAuth 2.0 para recibir un token de acceso que se usa para hacer una llamada a la API, debes especificar las APIs a las que se puede acceder con ese token. En el caso de la API de Authorized Buyers Marketplace, ese alcance es https://www.googleapis.com/auth/authorized-buyers-marketplace.

Cómo identificar segmentos de datos en la API en comparación con la selección en tiempo real

En la API de Marketplace, los segmentos de datos se identifican con un nombre de recurso específico de la API, como los siguientes:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

Cuando identifiques los segmentos de datos pertinentes para una oportunidad publicitaria en la Curación en tiempo real, especifica el valor del ID del recurso DATA_SEGMENT_ID en lugar del recurso name completo que utiliza la API.

Próximos pasos