Migrer de la version 4 à la version 5 de l'API Display & Video 360

Dernière mise à jour : 22/10/2026

Avertissement : La version 5 est en version bêta ouverte. Des modifications destructives peuvent être apportées à la v5 pendant la phase bêta. Elles seront listées dans les notes de version de l'API Display & Video 360. Ce document sera mis à jour si nécessaire pour refléter la version bêta en ligne.

Migrer votre application

Pour migrer de la version 4 vers la version 5, vous devez mettre à jour vos URL de point de terminaison pour appeler la version 5, mettre à jour votre application pour tenir compte des modifications destructives et examiner les nouvelles fonctionnalités susceptibles d'améliorer votre intégration.

Mettre à jour vos appels d'API de la v4 vers la v5

Pour utiliser la version 5 au lieu de la version 4, vous devez mettre à jour vos requêtes afin qu'elles utilisent les nouveaux points de terminaison de la version 5.

Par exemple, pour appeler la méthode advertisers.get avec la version 4, utilisez l'URL suivante :

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

Pour la v5, remplacez l'URL par la suivante :

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

Si vous utilisez une bibliothèque cliente pour envoyer des requêtes à l'API, utilisez la version la plus récente de la bibliothèque cliente et mettez à jour votre configuration pour utiliser la version 5.

Apporter les modifications requises

La version 5 de l'API Display & Video 360 introduit un certain nombre de modifications destructives. Consultez les instructions suivantes et apportez les modifications nécessaires à votre utilisation de l'API Display & Video 360.

Pour obtenir la liste exhaustive des différences entre les versions 4 et 5 de l'API Display & Video 360, consultez les notes de version.

Mettre à jour la récupération et le ciblage des sources d'inventaire pour utiliser de nouveaux ID et types

La version 5 de l'API Display & Video 360 modifie la façon dont les accords de sources d'inventaire et les packages d'enchères sont récupérés et ciblés.

Dans la version 4, les ressources InventorySource récupérées à l'aide du service inventorySources représentent à la fois les accords de source d'inventaire et les packages d'enchères. Les accords et les packages d'enchères sont ciblés à l'aide de TARGETING_TYPE_INVENTORY_SOURCE.

Dans la v5, les accords de sources d'inventaire et les packages d'enchères sont gérés séparément :

• Les accords de source d'inventaire sont ciblés à l'aide de TARGETING_TYPE_INVENTORY_SOURCE_DEAL, récupérés à l'aide des services advertisers.inventorySources et partners.inventorySources, et ciblés à l'aide du champ AssignedTargetingOption inventorySourceDetails.
• Les packages d'enchères sont ciblés à l'aide de TARGETING_TYPE_AUCTION_PACKAGE, récupérés à l'aide du service targetingTypes.targetingOptions et ciblés à l'aide du champ AssignedTargetingOption auctionPackageDetails.

Cette mise à jour modifie les ID utilisés pour les accords et les packages d'enchères existants. Vous ne pouvez donc pas utiliser les ID de ressource InventorySource précédemment mis en cache après la migration.

En plus de ces modifications, la version 5 supprime également la possibilité de créer, de mettre à jour et de modifier les accesseurs des sources d'inventaire.

Mettre à jour la logique de ciblage d'audience pour les ressources Demand Gen et YouTube

La version 5 de l'API Display & Video 360 met à jour la logique de ciblage d'audience pour les ressources Demand Gen et YouTube afin d'utiliser des options attribuées individuellement pour chaque liste d'audience ciblée.

Dans la v4, tout le ciblage d'audience est géré à l'aide de TARGETING_TYPE_AUDIENCE_GROUP.

Dans la v5, le ciblage d'audience attribué aux groupes d'annonces Demand Gen et YouTube est géré à l'aide de l'un des types de ciblage et des champs de ressource AssignedTargetingOption suivants, en fonction du type d'audience :

• TARGETING_TYPE_COMBINED_AUDIENCE à l'aide de combinedAudienceDetails
• TARGETING_TYPE_CUSTOM_LIST à l'aide de customListDetails
• TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE à l'aide de firstPartyAndPartnerAudienceDetails
• TARGETING_TYPE_GOOGLE_AUDIENCE à l'aide de googleAudienceDetails
• TARGETING_TYPE_LOOKALIKE_AUDIENCE à l'aide de lookalikeAudienceDetails

Les éléments de campagne continueront d'utiliser un seul TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption pour gérer le ciblage d'audience pour tous les types.

Passez à l'API Data Manager pour gérer les audiences de ciblage par liste de clients

La version 5 de l'API Display & Video 360 supprime la possibilité de créer et de gérer l'appartenance aux audiences de ciblage par liste de clients en supprimant les méthodes suivantes :

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

Pour continuer à gérer les audiences de ciblage par liste de clients, mettez à niveau vos workflows pour utiliser l'API Data Manager.

Ajout de la prise en charge de la récupération des ordres d'insertion de publicité extérieure numérique

La version 5 de l'API Display & Video 360 permet de récupérer les ordres d'insertion Digital Out of Home.

Si vos annonceurs utilisent la publicité extérieure numérique, mettez à niveau toute intégration appelant advertisers.insertionOrders.list en prévision de l'inclusion de ressources InsertionOrder avec la valeur de champ insertionOrderType de OUT_OF_HOME.

Dans la v5, les éléments de campagne des ordres d'insertion de publicité extérieure numérique continueront d'être récupérables comme dans la v4.

Remplacement des références à Adloox par Peer39

Dans la version 5, les champs et les valeurs d'énumération faisant référence à l'intégration de la brand suitability tierce de Display & Video 360 avec Adloox (également appelée Scope3) ont été remplacés par Peer39 :

• Le champ ThirdPartyVerifierAssignedTargetingOptionDetails adloox a été remplacé par peer39.
• Les valeurs d'énumération PARTNER_COST_TYPE_ADLOOX et PARTNER_COST_TYPE_ADLOOX_PREBID de PartnerCostType ont été remplacées par PARTNER_COST_TYPE_PEER39 et PARTNER_COST_TYPE_PEER39_PREBID.

Mettre à jour les champs des éléments de campagne, des groupes d'annonces et des annonces YouTube

Dans la version 5, plusieurs champs des ressources LineItem, AdGroup et AdGroupAd ont été supprimés ou mis à jour. Mettez à jour votre logique de récupération des ressources pour tenir compte de ces modifications.

Dans la ressource LineItem :

• relatedVideoIdsLe champ YoutubeAndPartnersSettings a été remplacé par relatedVideos.

Dans les ressources LineItem et AdGroup :

• Les champs audienceExpansionSeedListExcluded et audienceExpansionLevel de TargetingExpansionConfig ont été supprimés.

Dans la ressource AdGroupAd :

• Un champ containsSyntheticMedia a été ajouté.
• Le champ trackingUrl des objets AudioAd, CommonInStreamAttribute et VideoPerformanceAd a été divisé en deux champs, trackingUrl et userSpecifiedTrackingUrl, afin de différencier l'URL utilisée pour le suivi de l'URL de suivi spécifiée par l'utilisateur.

Supprimer les références aux valeurs d'énumération obsolètes

Dans la v5, les valeurs d'énumération précédemment obsolètes ont été complètement supprimées. Bien que l'utilisation de ces valeurs dans les requêtes adressées à l'API entraîne une erreur dans la version 4, cette modification supprime toute référence à ces valeurs dans les bibliothèques clientes de la version 5. Toute référence à ces valeurs obsolètes dans votre code peut entraîner des erreurs lors de la mise à niveau vers la version 5.

Les types d'énumération dont les valeurs sont affectées incluent ContentRatingTier, GoogleAudienceType, SdfVersion et SensitiveCategory. Consultez nos notes de version pour obtenir la liste exhaustive de toutes les valeurs d'énumération supprimées.

Découvrir les nouvelles fonctionnalités

En plus des modifications destructives, la v5 introduit également les nouvelles fonctionnalités suivantes :

• Gestion complète du ciblage par exclusion de vidéos et de chaînes YouTube au niveau de l'annonceur sous les types de ciblage TARGETING_TYPE_YOUTUBE_VIDEO et TARGETING_TYPE_YOUTUBE_CHANNEL. Dans la v4, ce ciblage était en lecture seule.
• Possibilité de créer des ressources de publicité extérieure numérique InsertionOrder.
• Prise en charge des groupes d'annonces utilisant des créations attribuées pour générer des annonces via l'ajout des champs AdGroup adSource et creativeAssignments, et du champ AdGroupAd parentCreativeId.
• Possibilité de créer et de récupérer des ressources LookalikeAudience.
• Un nouveau champ containsSyntheticMedia dans la ressource AdGroupAd.