La API de Display & Video 360 es la interfaz programática de la plataforma de Display & Video 360. Puedes usar la API de Display & Video 360 para automatizar flujos de trabajo complejos de Display & Video 360. Estos son algunos ejemplos de tareas que puedes realizar con la API de Display & Video 360:
- Sube y crea creatividades.
- Administra las líneas de pedido y su segmentación.
- Genera y descarga archivos de datos estructurados.
En esta guía, se describe cómo comenzar a usar la API de Display & Video 360.
Requisitos previos
Antes de usar la API de Display & Video 360, debes hacer lo siguiente:
Debes tener una Cuenta de Google. Necesitas una Cuenta de Google para crear un proyecto en la Consola de API de Google. Si ya tienes una cuenta, no tienes que hacer nada más. También puedes usar una Cuenta de Google independiente para fines de prueba.
Debes tener acceso a Display & Video 360. Necesitas acceso al producto Display & Video 360 para trabajar con la API. Si tu organización ya tiene un contrato de Display & Video 360, asegúrate de que se haya creado un perfil de usuario con los permisos adecuados para tus Cuentas de Google. De lo contrario, comunícate con nuestro equipo de ventas para obtener más información.
Te recomendamos que pruebes Display & Video 360. En esta documentación de la API, se da por sentado que usaste Display & Video 360 y que conoces los conceptos de programación web y los formatos de datos web. Si no usaste Display & Video 360, prueba la IU web antes de comenzar a codificar.
Elegir un proyecto
Debes crear o seleccionar un proyecto en la Consola de APIs de Google y habilitar la API.
Puedes crear un proyecto nuevo o usar uno existente.
Crea un proyecto nuevo
Sigue los pasos que se indican en la Consola de APIs de Google para crear un proyecto y habilitar automáticamente la API de Display & Video 360.
Usa un proyecto existente
A continuación, te mostramos cómo activar manualmente la API de Display & Video 360 para un proyecto existente.
Si deseas habilitar una API para tu proyecto, haz lo siguiente:
- Abre la Biblioteca de APIs en la Consola de APIs de Google. Si se te solicita, selecciona un proyecto o crea uno nuevo. La Biblioteca de API muestra todas las APIs disponibles, agrupadas por familia de productos y popularidad.
- Si la API que quieres habilitar no está en la lista, usa la búsqueda para encontrarla.
- Selecciona la API que deseas habilitar y, luego, haz clic en el botón Habilitar.
- Si se te solicita, habilita la facturación.
- Si se te solicita, acepta las Condiciones del Servicio de la API.
Genera credenciales
Se deben autorizar todas las solicitudes que realices a la API de Display & Video 360. Para obtener una breve descripción general de la autorización, lee sobre cómo autorizar e identificar tu aplicación a Google.
Las siguientes instrucciones te guiarán por el proceso de creación de un ID de cliente de OAuth 2.0 para usarlo con el flujo de la aplicación instalada. Si deseas obtener instrucciones para generar credenciales para usar con el flujo de la cuenta de servicio, consulta la guía Cuentas de servicio.
Sigue los pasos para configurar un proyecto de la Consola de APIs de Google.
- Abre la página Credenciales en la Consola de API.
Haz clic en Crear credenciales > ID de cliente de OAuth.
Selecciona el tipo de aplicación más aplicable cuando se te solicite. Los fragmentos de código de Java y Python que se ofrecen en estas guías suponen una app para computadoras, mientras que los fragmentos de código de PHP suponen una aplicación web.
Ingresa la información adicional requerida.
- Si es la primera vez que creas un ID de cliente, además de poder seleccionar el tipo de aplicación, puedes configurar la pantalla de consentimiento haciendo clic en el botón Configurar pantalla de consentimiento. No recibirás un mensaje para volver a configurar la pantalla de consentimiento después de hacerlo por primera vez, aunque esta información se puede actualizar en cualquier momento.
Haz clic en Crear.
Cuando termines, se te mostrará un ID de cliente y un secreto de cliente de OAuth 2.0, que puedes descargar en formato JSON y guardar para usarlos más adelante.
Configura la pantalla de consentimiento del usuario
Cuando usas OAuth 2.0 para la autenticación, tus usuarios se autentican después de aceptar los términos que se presentan en una pantalla de consentimiento del usuario.
Para establecer la pantalla de consentimiento de tu proyecto, haz lo siguiente:
- Abre la página Pantalla de consentimiento en la consola de la API de Google. Si se te solicita, selecciona un proyecto o crea uno nuevo.
- Completa el formulario y haz clic en Guardar.