Última actualización: 31 de octubre de 2023
Migra tu aplicación
La migración de v2 a v3 requiere actualizar tus URLs de extremo para llamar a v3 y actualizar tu aplicación a fin de que tenga en cuenta los cambios rotundos.
Actualiza tus llamadas a la API de la versión 2 a la 3
Si quieres usar v3 en lugar de v2, debes actualizar tus solicitudes para usar extremos nuevos de v3.
Por ejemplo, para llamar al método advertisers.get
con la versión 2, debes usar la siguiente URL:
GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId
Para v3, actualiza la URL a la siguiente:
GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId
Si usas una biblioteca cliente para realizar solicitudes a la API, utiliza la versión más reciente de la biblioteca cliente y actualiza tu configuración para usar v3.
Realiza los cambios necesarios
Presentamos varios cambios rotundos en la versión 3. Revisa las siguientes instrucciones y realiza los cambios necesarios que sean relevantes para tu uso actual de la API de Display & Video 360.
Actualizar las llamadas que recuperan recursos de YouTube y su segmentación relacionada
- Los recursos
YoutubeAdGroup
yYoutubeAdGroupAd
se reemplazaron por los recursosAdGroup
yAdGroupAd
. Estos recursos nuevos proporcionan información casi idéntica a la de los recursos de la versión 2, pero pueden usar nombres de campo o tipos de enumeración actualizados. En tu integración, reemplaza los usos de los recursosYoutubeAdGroup
oYoutubeAdGroupAd
por los recursosAdGroup
yAdGroupAd
, y actualiza las llamadas a los siguientes servicios de la v2 al servicio de la v3 correspondiente:- De
advertisers.youtubeAdGroupAds
aadvertisers.adGroupAds
- De
advertisers.youtubeAdGroups
aadvertisers.adGroups
- De
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
aadvertisers.adGroups.targetingTypes.assignedTargetingOptions
- De
- Las referencias a los objetos
YoutubeAndPartnersBiddingStrategy
se movieron a un nuevo campoyoutubeAndPartnersBid
dentro del objeto generalBiddingStrategy
. El campobiddingStrategy
se quitó del objetoYoutubeAndPartnersSettings
. Actualiza tu integración a fin de recuperar la estrategia de ofertas para los grupos de anuncios o las líneas de pedido de YouTube del objetoBiddingStrategy
en el campobidStrategy
del recursoLineItem
oAdGroup
. - Se cambió el nombre del campo
thirdPartyMeasurementSettings
athirdPartyMeasurementConfigs
en el objetoYoutubeAndPartnersSettings
y el del objetoYoutubeAndPartnersThirdPartyMeasurementSettings
aThirdPartyMeasurementConfigs
. Actualiza tu integración para recuperar la información de configuración de la medición de terceros mediante el objeto y el campo nuevos.
Incluir las configuraciones de facturación necesarias al crear anunciantes
billingConfig
ahora es un campo obligatorio en el recurso Advertiser
. Actualiza las solicitudes advertisers.create
para verificar que este campo esté configurado. Los datos de facturación predeterminados se pueden recuperar para el socio principal mediante el nuevo campo de recurso Partner
billingConfig
.
Usar un campo nuevo para controlar la segmentación optimizada
Un nuevo campo booleano enableOptimizedTargeting
reemplazó el campo targetingExpansionLevel
en el objeto TargetingExpansionConfig
.
Actualiza la integración del pedido de inserción para usar el nuevo campo de KPI
Un nuevo campo kpi
reemplazó el campo performanceGoal
en el recurso InsertionOrder
. Este campo nuevo usa un objeto Kpi
en lugar del objeto PerformanceGoal
, además de campos y enumeraciones nuevos.
Quita las referencias a servicios y campos obsoletos
En la versión 3, se quitaron varias entidades para alinearse con las bajas de funciones anteriores:
- Se quitó el servicio
advertisers.manualTriggers
porque los activadores manuales dejaron de estar disponibles. - Se quitó el campo
billableOutcome
del recursoInsertionOrder
porque la compra basada en resultados dejó de estar disponible.
Cambios adicionales
Además de los cambios rotundos mencionados anteriormente, la v3 también presenta funciones nuevas.
Puedes encontrar las funciones que se agregaron a la versión 3 después del lanzamiento inicial en nuestras notas de la versión.
Administración de listas de ubicaciones por proximidad
En la v3, puedes administrar por completo las listas de ubicaciones de proximidad, lo que te permite usar el servicio advertisers.locationLists.assignedLocations
para crear y borrar ubicaciones asignadas a recursos TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. Las ubicaciones se identifican con el ID de los recursos TARGETING_TYPE_POI
TargetingOption
. Estos se pueden recuperar con targetingTypes.targetingOptions.search
.
La capacidad de crear algoritmos de ofertas personalizadas basados en reglas
En la versión 3, puedes crear y recuperar algoritmos de ofertas personalizadas basadas en reglas mediante los servicios customBiddingAlgorithms
, media
y customBiddingAlgorithms.rules
.
Esta función se encuentra en versión beta y solo está disponible para los socios incluidos en la lista de entidades permitidas. Si tu socio no está incluido en la lista de entidades permitidas, tu solicitud mostrará un error.