Cómo migrar de v3 a v4

Última actualización: 27 de marzo de 2025

Migra tu aplicación

Para migrar de la v3 a la v4, debes actualizar las URLs de extremo para llamar a la v4 y actualizar tu aplicación para tener en cuenta los cambios rotundos.

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

Para usar la versión 4 en lugar de la 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

Para 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 la 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 en función del uso que ya haces de la API de Display & Video 360.

Llamadas de actualización sobre los recursos de públicos propios 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
• Solicitudes existentes a métodos en el servicio firstAndThirdPartyAudiences de la versión 3 al nuevo servicio firstPartyAndPartnerAudiences de la versión 4
• Expectativas del tamaño de página predeterminado para solicitudes de firstPartyAndPartnerAudiences.list de 100 a 5,000 elementos.
• Referencias del campo firstAndThirdPartyAudienceType de la versión 3 al nuevo campo firstPartyAndPartnerAudienceType de la versión 4, con el nuevo tipo de enumeración FirstPartyAndPartnerAudienceType, con los valores anteriores correspondientes 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

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

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Referencias a recursos AssignedTargetingOption de TargetingType TARGETING_TYPE_AUDIENCE_GROUP para reemplazar los campos de v3 en AudienceGroupAssignedTargetingOptionDetails por los siguientes campos nuevos de v4:

  • excludedFirstAndThirdPartyAudienceGroup con excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups con includedFirstPartyAndPartnerAudienceGroups

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

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

Cómo incluir un objetivo de optimización cuando creas 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 todas las solicitudes para administrar o recuperar la segmentación de la campaña o del pedido de inserción.

Se quitó la capacidad de recuperar o administrar la segmentación de las campañas o los pedidos de inserción. Quita todas las solicitudes a los siguientes servicios o métodos:

• Servicio advertisers.campaigns.targetingTypes.assignedTargetingOptions
• Servicio advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
• Método advertisers.campaigns.listAssignedTargetingOptions
• Método advertisers.insertionOrders.listAssignedTargetingOptions

Se quitaron las referencias al campo de recursos de creatividad publisherReviewStatuses

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