Cómo migrar de v3 a v4

Última actualización: 31 de julio de 2025

Migra tu aplicación

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

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

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

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

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

En la versión 4, actualiza la URL a la siguiente:

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

Realiza los cambios necesarios

Presentamos varios cambios rotundos en la versión 4. 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 sobre los recursos de público de origen y de terceros, y la segmentación relacionada

Los recursos FirstAndThirdPartyAudience se reemplazaron por recursos FirstPartyAndPartnerAudience.

Este cambio requiere que actualices lo siguiente:

• Referencias a recursos FirstAndThirdPartyAudience para usar el nuevo recurso FirstPartyAndPartnerAudience
• Las solicitudes existentes a los métodos del servicio firstAndThirdPartyAudiences de la versión 3 se migran al nuevo servicio firstPartyAndPartnerAudiences de la versión 4.
• Expectativas del tamaño de página predeterminado para las solicitudes de firstPartyAndPartnerAudiences.list de 100 a 5,000 elementos.
• Se hace referencia al campo firstAndThirdPartyAudienceType de la versión 3 con el nuevo campo firstPartyAndPartnerAudienceType de la versión 4, utilizando el nuevo tipo de enumeración FirstPartyAndPartnerAudienceType, con los valores antiguos que corresponden a los siguientes valores nuevos:
  • De FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY a TYPE_FIRST_PARTY
  • De FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY a TYPE_PARTNER

• Se reemplazan las referencias al valor de enumeración AudienceType LICENSED para usar uno de los siguientes valores nuevos y más específicos:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Referencias a los recursos AssignedTargetingOption de TargetingType TARGETING_TYPE_AUDIENCE_GROUP para reemplazar los campos de la versión 3 en AudienceGroupAssignedTargetingOptionDetails con los siguientes campos nuevos de la versión 4:

  • excludedFirstAndThirdPartyAudienceGroup con excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups con includedFirstPartyAndPartnerAudienceGroups

Actualiza las solicitudes existentes de segmentación por lista masiva de grupos de anuncios

Se cambió el nombre de advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions a advertisers.adGroups.bulkListAssignedTargetingOptions. Actualiza tus solicitudes existentes para usar el nuevo nombre del método.

Incluye un objetivo de optimización cuando crees pedidos de inserción

optimizationObjective ahora es un campo obligatorio en el recurso InsertionOrder. Actualiza tus solicitudes de advertisers.insertionOrders.create para verificar que este campo esté configurado.

Quita las referencias al campo de recursos de la creatividad publisherReviewStatuses

El campo publisherReviewStatuses se quitó del objeto ReviewStatusInfo en el recurso Creative después de que dejó de estar disponible en junio de 2024.