La API de Reporting de DV360 Exchange proporciona a los socios de Third-Party Exchange (3PE) acceso programático a los informes de rendimiento de Display &Video 360.
La API de Reporting de DV360 Exchange se expone como una API de Google Cloud basada en una lista de entidades permitidas que usa OAuth. El proceso de la lista de entidades permitidas lo administra el equipo de la API de Reporting de DV360 Exchange.
Procedimiento
Estos son los pasos de incorporación de la API de Reporting de DV360 Exchange:
Registra una Cuenta de Google en la Google Cloud consola.
Ten en cuenta que esta cuenta se usará para administrar los tokens de acceso de tu cliente de producción, por lo que no debes usar tu cuenta personal de Gmail.
Comunícate con Google DV360 con la información de la cuenta para que se agregue a la lista de entidades permitidas.
Después de que se te notifique que estás en la lista de entidades permitidas, solicita una revisión de verificación de OAuth para que tu app obtenga acceso al alcance
doubleclickbidmanager.Accede a la consola de Google Cloud.
Navega a API y servicios > Biblioteca > Privada. Deberías ver la API de Reporting de DV360 Exchange como una de las APIs disponibles. Habilita la API de Reporting de DV360 Exchange.
Navega a Credenciales > Crear una credencial > Clave de cuenta de servicio. Sigue las instrucciones para crear una cuenta de servicio.
Cuenta de servicio
Una cuenta de servicio permite que tu código envíe credenciales de la aplicación directamente a la API. Una cuenta de servicio, como una cuenta de usuario, se representa mediante una dirección de correo electrónico. Sin embargo, a diferencia de una cuenta de usuario, una cuenta de servicio pertenece solo a una aplicación y solo se puede usar para acceder a la API para la que se creó.
Estos son los pasos para crear credenciales de cuenta de servicio con la consola de Google Cloud:
En la página Administrador de APIs > Credenciales, selecciona Crear credenciales > Clave de cuenta de servicio.
Selecciona Nueva cuenta de servicio en el menú desplegable Cuenta de servicio.
Ingresa un Nombre para esta cuenta de servicio. Este nombre se utiliza como el nombre predeterminado para tu ID de cuenta de servicio, a la izquierda de la
@en la dirección de ID de la cuenta de servicio generada.En Tipo de clave, te recomendamos que dejes este valor como
JSON. Haz clic en Crear para generar una clave JSON como un archivo de texto.json. Cuando se te solicite, descarga el archivo en tu computadora y se mostrará un diálogo de Cuenta de servicio creada.
Esta es una clave JSON de muestra:
{ "type": "service_account", "project_id": "project-id", "private_key_id": "some_number", "private_key": "-----BEGIN PRIVATE KEY-----\n.... =\n-----END PRIVATE KEY-----\n", "client_email": "<api-name>api@project-id.iam.gserviceaccount.com", "client_id": "...", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com" }Almacena tu archivo JSON de forma segura, ya que contiene tu clave privada, y este archivo es la única copia de esa clave. Las credenciales de este archivo son necesarias cuando tu código realiza llamadas a la API.
Comunícate con DV360 con la información de la cuenta de servicio que creaste, específicamente, la dirección de correo electrónico de la cuenta de servicio. Esto forma parte del proceso de la lista de entidades permitidas para el acceso a la API.
Token de acceso
Después de que se autorice tu cuenta de servicio para realizar llamadas a la API, puedes continuar con los ejemplos de las guías de la API. Para obtener un token de acceso de forma manual, puedes usar una herramienta como oauth2l o una de nuestras bibliotecas cliente para autenticarte de forma programática.