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 las tareas que puedes realizar con la API de Display & Video 360:
- Sube y diseña 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 necesitas hacer nada más. También es posible que desees tener una Cuenta de Google separada para realizar pruebas.
Debes tener acceso a Display & Video 360. Necesitas acceso al producto de 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.
Deberías probar Display & Video 360. En esta documentación de la API, se supone que usaste Display & Video 360 y que conoces los conceptos de programación web y los formatos de datos web. Si aún no usaste Display & Video 360, prueba la IU web antes de comenzar a programar.
Elige un proyecto
Debes crear o seleccionar un proyecto en la Consola de API de Google y habilitar la API.
Puedes crear un proyecto nuevo o usar uno existente.
Creación de un proyecto nuevo
Sigue los pasos que se indican en la Consola de API de Google para crear un proyecto y habilitar la API de Display & Video 360 automáticamente.
Usa un proyecto existente
Aquí te mostramos cómo activar manualmente la API de Display & Video 360 en un proyecto existente.
Si deseas habilitar una API para tu proyecto, haz lo siguiente:
- Abre la Biblioteca de API en la Consola de APIs de Google. Si se te solicita, selecciona un proyecto o crea uno nuevo. La biblioteca de API enumera 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 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, consulta cómo autorizar e identificar tu aplicación ante Google.
Las siguientes instrucciones te guiarán en el proceso de creación de un ID de cliente de OAuth 2.0 para usar con el flujo de la aplicación instalada. Si deseas obtener instrucciones sobre cómo 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 de escritorio, mientras que los fragmentos de código 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 si haces 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 la primera vez, aunque esta información se puede actualizar en cualquier momento.
Haz clic en Crear.
Cuando hayas terminado, verás un ID y un secreto de cliente de OAuth 2.0, que puedes descargar en formato JSON y guardarlos para usarlos en otro momento.
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 les presentan en una pantalla de consentimiento del usuario.
Para establecer la pantalla de consentimiento de tu proyecto, haz lo siguiente:
- Abre la página de la Pantalla de consentimiento en la Consola de APIs de Google. Si se te solicita, selecciona un proyecto o crea uno nuevo.
- Completa el formulario y haz clic en Guardar.