Descripción general

Puedes crear y administrar segmentos de datos con la API de Curation Partners, 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, se explica cómo configurar una cuenta de servicio para acceder a la API de Curation Partners.

  1. Si aún no lo hiciste, crea un proyecto de Google Cloud que aloje tus credenciales que se usan para acceder a la API.

  2. Ve a la página APIs habilitadas de la consola de Google Cloud. Selecciona el proyecto que creaste anteriormente.

  3. Revisa la lista de APIs y servicios habilitados. Para acceder a la API de Curation Partners, debes habilitarla. Si la API de Curation Partners no está habilitada, haz clic en +Habilitar APIs y servicios y sigue las siguientes instrucciones:

    1. Busca API de Curation Partners con el cuadro de búsqueda.
    2. Selecciona API de Curation Partners en la página de resultados.
    3. Haz clic en Habilitar.

    Es un problema conocido que es posible que no puedas encontrar la API de Curation Partners con el cuadro de búsqueda de la consola de Google Cloud. Como alternativa, puedes usar Google Cloud CLI para habilitar la API. Después de instalar gcloud CLI, puedes habilitar la API de Curation Partners con el siguiente comando:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  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. 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 de 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 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 cuenta de servicio con tu administrador técnico de cuentas para vincular la cuenta de servicio con tu cuenta.

Alcances de la API

Cuando sigas el flujo de OAuth 2.0 para recibir un token de acceso que se usa para realizar una llamada a la API, debes especificar las APIs a las que se puede acceder con ese token. Para la API de Curation Partners, ese alcance es https://www.googleapis.com/auth/curation-partners.

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

En la API de Curation Partners, los segmentos de datos se identifican con un nombre de recurso específico de la API, como el siguiente:

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

Cuando identifiques los segmentos de datos relevantes para una oportunidad publicitaria en Curation en tiempo real, especifica el valor del ID de recurso DATA_SEGMENT_ID en lugar del nombre de recurso completo que proporciona la API en el campo name.

Próximos pasos