Migra de v2 a v3

Última actualización: 31 de octubre de 2023

Migra tu aplicación

Para migrar de v2 a v3, es necesario actualizar las URLs de tu extremo para llamar a v3 y actualizando tu aplicación para dar cuenta de los cambios rotundos.

Actualiza tus llamadas a la API de v2 a v3

Si quieres usar v3 en lugar de v2, debes actualizar tus solicitudes para usar la nueva v3 en los extremos.

Por ejemplo, para llamar al método advertisers.get con v2, debes usa la siguiente URL:

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

Para la versión 3, actualiza la URL a lo siguiente:

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

Si usas una biblioteca cliente para realizar solicitudes a la API, usa el a 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 lo siguiente instrucciones y realizar los cambios necesarios que sean relevantes para su uso actual del Anuncios gráficos y API de Video 360.

Actualiza las llamadas en las que se recuperan los recursos de YouTube y la segmentación relacionada

• Los recursos YoutubeAdGroup y YoutubeAdGroupAd se reemplazaron por AdGroup y AdGroupAd. Estos nuevos recursos te brindan información casi idéntica a la de los recursos de la v2, pero puede usar campos actualizados o tipos de enumeración. En tu integración, reemplaza los usos de Recursos YoutubeAdGroup o YoutubeAdGroupAd con AdGroup y AdGroupAd y llamadas de actualización a los siguientes servicios v2 para el servicio v3 correspondiente:
  • De advertisers.youtubeAdGroupAds a advertisers.adGroupAds
  • De advertisers.youtubeAdGroups a advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions a advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Referencias a objetos YoutubeAndPartnersBiddingStrategy se movieron a un nuevo campo youtubeAndPartnersBid dentro del objeto BiddingStrategy general. El El campo biddingStrategy se quitó de la Objeto YoutubeAndPartnersSettings. Actualiza tu integración para Recuperar la estrategia de ofertas para las líneas de pedido o los grupos de anuncios de YouTube desde la Un objeto BiddingStrategy en el campo bidStrategy de los recursos LineItem o AdGroup.
• Se cambió el nombre del campo thirdPartyMeasurementSettings a thirdPartyMeasurementConfigs en el objeto YoutubeAndPartnersSettings y la Se cambió el nombre del objeto YoutubeAndPartnersThirdPartyMeasurementSettings a ThirdPartyMeasurementConfigs. Actualiza tu integración para Recuperar información de configuración de la medición de terceros con el nuevo campo y objeto.

Incluir las configuraciones de facturación necesarias al crear anunciantes

billingConfig ahora es un campo obligatorio en la Advertiser recurso. Actualiza tu advertisers.create. para verificar que este campo esté configurado. Los datos de facturación predeterminados se pueden se recuperará para el socio superior a través del nuevo Partner campo billingConfig del recurso.

Utilice el nuevo campo para controlar la segmentación optimizada

Un nuevo campo booleano enableOptimizedTargeting reemplazó al Campo targetingExpansionLevel en TargetingExpansionConfig .

Actualiza la integración del pedido de inserción para usar el nuevo campo de KPI

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

Quita las referencias a servicios y campos obsoletos

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

• El servicio advertisers.manualTriggers se quitó como activadores manuales dejaron de estar disponibles.
• El campo billableOutcome se quitó de la recurso InsertionOrder ya que la compra basada en resultados se ha obsoleta.

Cambios adicionales

Además de los cambios rotundos mencionados anteriormente, la v3 también presenta atributos.

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

Administración de listas de ubicaciones de proximidad

En la versión 3, puedes administrar completamente las listas de ubicaciones de proximidad, lo que te permite usa el servicio advertisers.locationLists.assignedLocations para crear y borrar las ubicaciones asignadas a TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Las ubicaciones se identifican mediante el ID de TARGETING_TYPE_POI TargetingOption recursos. Estas pueden ser recuperadas con targetingTypes.targetingOptions.search.

Capacidad de crear algoritmos de ofertas personalizadas basados en reglas

En la v3, puedes crear y recuperar algoritmos de ofertas personalizadas basados en reglas con el customBiddingAlgorithms, media servicios de 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 el si el socio no está incluido en la lista de entidades permitidas, tu solicitud mostrará un error.