Migra de v2 a v3

Última actualización: 31 de octubre de 2023

Migra tu aplicación

La migración de la versión 2 a la versión 3 requiere que actualices las URLs de los extremos para llamar a la versión 3 y que actualices tu aplicación para tener en cuenta los cambios rotundos.

Actualiza tus llamadas a la API de la versión 2 a la versión 3

Para usar la versión 3 en lugar de la versión 2, debes actualizar tus solicitudes para que usen los nuevos extremos de la versión 3.

Por ejemplo, para llamar al método advertisers.get con la versión 2, usarías la siguiente URL:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

En la versión 3, 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, usa la versión más reciente de la biblioteca cliente y actualiza tu configuración para usar la versión 3.

Realiza los cambios necesarios

Presentamos varios cambios rotundos en la versión 3. Revisa las siguientes instrucciones y realiza los cambios necesarios relacionados con el uso existente de la API de Display & Video 360.

Llamadas de actualización 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 campos 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 versión 2 al servicio correspondiente de la versión 3:
  • advertisers.youtubeAdGroupAds a advertisers.adGroupAds
  • advertisers.youtubeAdGroups a advertisers.adGroups
  • 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 BiddingStrategy general. Se quitó el campo biddingStrategy del objeto YoutubeAndPartnersSettings. Actualiza tu integración para recuperar la estrategia de ofertas de las líneas de pedido o los grupos de anuncios de YouTube desde el 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 nombre del objeto YoutubeAndPartnersThirdPartyMeasurementSettings a ThirdPartyMeasurementConfigs. Actualiza tu integración para recuperar la información de configuración de medición de terceros con el nuevo campo y objeto.

Incluye la configuración de facturación requerida cuando crees anunciantes

billingConfig ahora es un campo obligatorio en el recurso Advertiser. Actualiza tus solicitudes de advertisers.create para verificar que este campo esté configurado. La información de facturación predeterminada se puede recuperar para el socio principal a través del nuevo campo billingConfig del recurso Partner.

Usa un campo nuevo para controlar la segmentación optimizada

Un nuevo campo booleano enableOptimizedTargeting reemplazó el campo targetingExpansionLevel en el objeto TargetingExpansionConfig.

Se actualizó la integración de la orden de inserción para usar el nuevo campo de KPI

Un nuevo campo kpi reemplazó al campo performanceGoal en el recurso InsertionOrder. Este nuevo campo usa un objeto Kpi en lugar del objeto PerformanceGoal y usa nuevos campos y enumeraciones.

Quita las referencias a los servicios y campos obsoletos

En la versión 3, se quitaron varias entidades para alinearse con las obsolescencias de funciones anteriores:

• Se quitó el servicio advertisers.manualTriggers porque se dejaron de admitir los activadores manuales.
• El campo billableOutcome se quitó del recurso InsertionOrder porque las compras basadas en resultados dejaron de estar disponibles.

Cambios adicionales

Además de los cambios rotundos mencionados anteriormente, la versión 3 también presenta nuevas funciones.

Las funciones que se agregaron a la versión 3 después del lanzamiento inicial se pueden encontrar en nuestras notas de la versión.

Administración de la lista de ubicaciones de proximidad

En la versión 3, puedes administrar por completo las listas de ubicaciones cercanas, 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. Se pueden recuperar con targetingTypes.targetingOptions.search.

Capacidad de crear algoritmos de ofertas personalizadas basados en reglas

En la versión 3, puedes compilar y recuperar algoritmos de ofertas personalizadas basados en reglas con los servicios customBiddingAlgorithms, media y customBiddingAlgorithms.rules.

Esta función está en versión beta y solo está disponible para los socios incluidos en la lista de entidades permitidas. Si tu socio no está en la lista de entidades permitidas, tu solicitud mostrará un error.