Migra de la API de Display & Video 360 v4 a la v5

Última actualización: 22 de octubre de 2026

Advertencia: La versión 5 se encuentra en versión beta abierta. Es posible que se realicen cambios rotundos en la versión v5 mientras esté en fase beta, los cuales se indicarán en las notas de la versión de la API de Display & Video 360. Este documento se actualizará según sea necesario para reflejar la versión beta en vivo.

Migra tu aplicación

Para migrar de la versión 4 a la 5, debes actualizar las URLs de tus extremos para llamar a la versión 5, actualizar tu aplicación para tener en cuenta los cambios rotundos y revisar las funciones nuevas que puedan beneficiar tu integración.

Actualiza tus llamadas a la API de la versión 4 a la 5

Para usar la versión 5 en lugar de la 4, debes actualizar tus solicitudes para usar los nuevos extremos de la versión 5.

Por ejemplo, para llamar al método advertisers.get con la versión 4, usa la siguiente URL:

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

Para la versión 5, actualiza la URL a la siguiente:

GET https://displayvideo.googleapis.com/v5/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 v5.

Realiza los cambios necesarios

La versión 5 de la API de Display & Video 360 presenta varios cambios rotundos. Revisa las siguientes instrucciones y realiza los cambios necesarios para el uso que haces de la API de Display & Video 360.

Para obtener una lista exhaustiva de las diferencias entre la API de Display & Video 360 v4 y v5, consulta las notas de la versión.

Actualiza la recuperación y la segmentación de fuentes de inventario para usar los IDs y tipos nuevos

La API de Display & Video 360 v5 cambia la forma en que se recuperan y segmentan los acuerdos de fuentes de inventario y los paquetes de subastas.

En la versión 4, los recursos InventorySource que se recuperan con el servicio inventorySources representan tanto los acuerdos de fuentes de inventario como los paquetes de subasta. Tanto los acuerdos como los paquetes de subasta se segmentan con TARGETING_TYPE_INVENTORY_SOURCE.

En la versión 5, los acuerdos de fuentes de inventario y los paquetes de subasta se controlan por separado:

• La segmentación de los acuerdos de fuentes de inventario se realiza con TARGETING_TYPE_INVENTORY_SOURCE_DEAL, se recuperan con los servicios advertisers.inventorySources y partners.inventorySources, y se segmentan con el campo AssignedTargetingOption inventorySourceDetails.
• Los paquetes de subasta se segmentan con TARGETING_TYPE_AUCTION_PACKAGE, se recuperan con el servicio targetingTypes.targetingOptions y se segmentan con el campo AssignedTargetingOption auctionPackageDetails.

Esta actualización cambia los IDs que se usan para los acuerdos y paquetes de subasta existentes, por lo que no puedes usar ningún ID de recurso InventorySource almacenado en caché anteriormente después de la migración.

Además de estos cambios, la versión 5 también quita la capacidad de crear, actualizar y editar descriptores de acceso de las fuentes de inventario.

Actualizar la lógica de segmentación por público para los recursos de campaña de generación de demanda y YouTube

La versión 5 de la API de Display & Video 360 actualiza la lógica de segmentación por público para los recursos de campaña de generación de demanda y YouTube, de modo que se usen opciones asignadas individuales para cada lista de público objetivo.

En la versión 4, toda la segmentación por público se administra con TARGETING_TYPE_AUDIENCE_GROUP.

En la versión 5, la segmentación por público asignada a los grupos de anuncios de YouTube y de generación de demanda se administra con uno de los siguientes tipos de segmentación y campos de recursos de AssignedTargetingOption, según el tipo de público:

• TARGETING_TYPE_COMBINED_AUDIENCE con combinedAudienceDetails
• TARGETING_TYPE_CUSTOM_LIST con customListDetails
• TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE con firstPartyAndPartnerAudienceDetails
• TARGETING_TYPE_GOOGLE_AUDIENCE con googleAudienceDetails
• TARGETING_TYPE_LOOKALIKE_AUDIENCE con lookalikeAudienceDetails

Las líneas de pedido seguirán usando un solo TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption para administrar la segmentación por público de todos los tipos.

Actualiza a la API de Data Manager para administrar los públicos de Segmentación por clientes

La versión 5 de la API de Display & Video 360 quita la capacidad de crear y administrar la membresía de los públicos de Segmentación por clientes, ya que quita los siguientes métodos:

• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• firstPartyAndPartnerAudiences.patch

Para seguir administrando los públicos de Segmentación por clientes, actualiza tus flujos de trabajo para usar la API de Data Manager.

Se agregó compatibilidad para recuperar pedidos de inserción de publicidad digital exterior.

La versión 5 de la API de Display & Video 360 agrega compatibilidad para recuperar pedidos de inserción de publicidad digital exterior.

Si tus anunciantes usan la publicidad digital exterior, actualiza cualquier integración que llame a advertisers.insertionOrders.list antes de la inclusión de recursos InsertionOrder con el valor de campo insertionOrderType de OUT_OF_HOME.

En la versión 5, las líneas de pedido de los pedidos de inserción de publicidad digital exterior se seguirán recuperando como en la versión 4.

Actualiza las referencias de Adloox a Peer39

En la versión 5, se actualizaron a Peer39 los campos y los valores de enumeración que hacen referencia a la integración de la idoneidad para la marca de terceros de Display & Video 360 con Adloox (también conocida como Scope3):

• El campo adloox de ThirdPartyVerifierAssignedTargetingOptionDetails se reemplazó por peer39.
• Los valores de enumeración PartnerCostType PARTNER_COST_TYPE_ADLOOX y PARTNER_COST_TYPE_ADLOOX_PREBID se reemplazaron por PARTNER_COST_TYPE_PEER39 y PARTNER_COST_TYPE_PEER39_PREBID.

Actualiza los campos de las líneas de pedido, los grupos de anuncios y los anuncios de YouTube

En la versión v5, se quitaron o actualizaron varios campos de los recursos LineItem, AdGroup y AdGroupAd. Actualiza tu lógica de recuperación de recursos para tener en cuenta estos cambios.

En el recurso LineItem:

• El campo YoutubeAndPartnersSettings relatedVideoIds se reemplazó por relatedVideos.

En los recursos LineItem y AdGroup, haz lo siguiente:

• Se quitaron los campos audienceExpansionSeedListExcluded y audienceExpansionLevel de TargetingExpansionConfig.

En el recurso AdGroupAd:

• Se agregó un campo containsSyntheticMedia.
• El campo trackingUrl de los objetos AudioAd, CommonInStreamAttribute y VideoPerformanceAd se dividió en dos campos, trackingUrl y userSpecifiedTrackingUrl, para diferenciar la URL que se usa para el seguimiento de la URL de seguimiento que especifica el usuario.

Quita las referencias a los valores de enum obsoletos

En la versión 5, se quitaron por completo los valores de enumeración que antes estaban obsoletos. Si bien el uso de estos valores en las solicitudes a la API generaría un error en la versión 4, este cambio quita cualquier referencia a ellos de las bibliotecas cliente de la versión 5. Cualquier referencia a estos valores obsoletos en tu código puede causar errores cuando actualices a la versión 5.

Los tipos de enumeración que tienen valores afectados incluyen ContentRatingTier, GoogleAudienceType, SdfVersion y SensitiveCategory. Consulta nuestras notas de la versión para obtener una lista exhaustiva de todos los valores de enumeración quitados.

Revisa las funciones nuevas

Además de los cambios rotundos, la versión 5 también presenta las siguientes funciones nuevas:

• Administración completa de la segmentación por exclusión de videos y canales de YouTube a nivel del anunciante en los tipos de segmentación TARGETING_TYPE_YOUTUBE_VIDEO y TARGETING_TYPE_YOUTUBE_CHANNEL En la versión 4, esta segmentación era de solo lectura.
• La capacidad de crear recursos de publicidad digital exterior InsertionOrder.
• Se agregó compatibilidad con los grupos de anuncios que usan creatividades asignadas para generar anuncios a través de la adición de los campos AdGroup adSource y creativeAssignments, y el campo AdGroupAd parentCreativeId.
• La capacidad de crear y recuperar recursos LookalikeAudience.
• Un nuevo campo containsSyntheticMedia en el recurso AdGroupAd.