General
¿Cuál es la versión más reciente de la API?
La versión más reciente de la API a la que se hace referencia en este documento es v4.
¿Puedo recuperar datos de rendimiento con esta API?
No. Usa la API de Bid Manager para crear, recuperar y ejecutar informes sin conexión de Display & Video 360.
Cómo usar la API
¿Qué URL debo usar para acceder a la API?
https://displayvideo.googleapis.com
¿Qué métodos de autenticación se admiten?
OAuth 2.0 es el único método de autenticación compatible.
Las solicitudes a la API de Display & Video 360 deben estar autorizadas para el siguiente permiso:
https://www.googleapis.com/auth/display-video
Las solicitudes al servicio users también deben estar autorizadas para el siguiente permiso adicional:
https://www.googleapis.com/auth/display-video-user-management
Quiero escribir código. ¿Dónde puedo encontrar las bibliotecas cliente?
Consulta la guía de la biblioteca cliente.
¿Qué sucede si no quiero usar una biblioteca cliente?
Te recomendamos que uses una de nuestras bibliotecas cliente, pero también puedes interactuar con la API de Display & Video 360 mediante solicitudes HTTP directas.
Algunos métodos más complejos, como advertisers.assets.upload y media.upload, son más difíciles de traducir directamente a solicitudes HTTP. Consulta ejemplos de solicitudes HTTP a estos métodos con cURL en nuestras guías de creativas y ofertas personalizadas.
¿Qué permisos de Display & Video 360 necesito?
Para usar la API de Display & Video 360, la Cuenta de Google que realiza la autenticación debe ser un usuario de Display & Video 360 con acceso a los socios o anunciantes relevantes.
El usuario de Display & Video 360 debe tener uno de los siguientes roles de usuario para que los socios o anunciantes relevantes realicen las siguientes acciones:
- Solo lectura: Recupera recursos con llamadas
getolist, sin incluir los recursosuser. - Estándar: Recupera, crea y actualiza recursos. Recupera recursos
usercon permisos para los mismos socios o anunciantes. - Administrador: Recupera, crea y actualiza recursos. Recupera, crea y otorga acceso a los recursos de
userpara los socios o anunciantes que administras.
¿Cómo actualizo los recursos de YouTube y socios con la API?
La API de Display & Video 360 no admite la creación ni la actualización de recursos de YouTube y socios. Sube archivos de datos estructurados (SDF) a la interfaz de Display & Video 360 para crear o actualizar recursos de YouTube y socios de forma masiva. Para obtener más detalles sobre cómo usar la carga de SDF, consulta nuestra página de guía sobre los recursos de YouTube y los socios.
¿Cómo segmentar anuncios para ubicaciones geográficas?
La segmentación geográfica se puede asignar a las líneas de pedido con los siguientes tipos de segmentación:
TARGETING_TYPE_GEO_REGIONTARGETING_TYPE_POITARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_TYPE_PROXIMITY_LOCATION_LIST
Recupera los IDs de las opciones de segmentación de los tres primeros tipos de segmentación con targetingTypes.targetingOptions.search. Recupera y administra los recursos de la lista de ubicaciones con el servicio advertisers.locationLists.
Además, también puedes crear un ID de opción de segmentación TARGETING_TYPE_POI para segmentar directamente un radio de proximidad alrededor de coordenadas de latitud y longitud específicas.
Veo que puedo descargar archivos de datos estructurados (SDF) con la API, pero ¿cómo los subo?
La API de Display & Video 360 no admite la carga de SDF. Te recomendamos administrar los recursos a través de los métodos CREATE, PATCH y DELETE que proporciona la API. Si aún deseas administrar recursos con SDF, esos archivos se pueden actualizar en la interfaz de Display & Video 360.
Asistencia
¿La API tiene algún problema o limitación conocidos?
Existen límites para la cantidad de solicitudes que puede realizar tu proyecto por segundo, que se describen en nuestra guía de límites de uso.