Migra de v2 a v3

Ú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 y YoutubeAdGroupAd se reemplazaron por los recursos AdGroup y AdGroupAd. 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 recursos YoutubeAdGroup o YoutubeAdGroupAd por los recursos AdGroup y AdGroupAd, y actualiza las llamadas a los siguientes servicios de la v2 al servicio de la v3 correspondiente:
  • De advertisers.youtubeAdGroupAds a advertisers.adGroupAds
  • De advertisers.youtubeAdGroups a advertisers.adGroups
  • De advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions a advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Las referencias a los objetos YoutubeAndPartnersBiddingStrategy se movieron a un nuevo campo youtubeAndPartnersBid dentro del objeto general BiddingStrategy. El campo biddingStrategy se quitó del objeto YoutubeAndPartnersSettings. 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 objeto BiddingStrategy en el campo bidStrategy del recurso LineItem o AdGroup.
• Se cambió el nombre del campo thirdPartyMeasurementSettings a thirdPartyMeasurementConfigs en el objeto YoutubeAndPartnersSettings y el del objeto YoutubeAndPartnersThirdPartyMeasurementSettings a ThirdPartyMeasurementConfigs. 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 recurso InsertionOrder 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.