Display & Abandon de la version 2 de l'API Video 360. Utilisez les campagnes Réseau Display et API Video 360 version 3. Pour obtenir des instructions sur la migration de la v2 à la v3, consultez notre guide de migration.

Cette page a été traduite par l'API Cloud Translation.

Passer de la v2 à la v3

Dernière mise à jour: 31/10/2023

Migrer votre application

Pour migrer de la version 2 vers la version 3, vous devez mettre à jour vos URL de point de terminaison pour appeler la version 3 et mettre à jour votre application pour qu'elle tienne compte des modifications destructives.

Passer de la version 2 à la version 3 de vos appels d'API

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

Par exemple, pour appeler la méthode advertisers.get avec la version 2, vous devez utiliser l'URL suivante:

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

Pour la version 3, remplacez l'URL par la suivante:

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

Apporter les modifications requises

Nous apportons un certain nombre de modifications importantes dans la version 3. Consultez les instructions suivantes et apportez les modifications requises en fonction de votre utilisation actuelle de l'API Display & Video 360.

Mettre à jour les appels qui récupèrent les ressources YouTube et leur ciblage associé

Les ressources YoutubeAdGroup et YoutubeAdGroupAd ont été remplacées par les ressources AdGroup et AdGroupAd. Ces nouvelles ressources fournissent des informations presque identiques à celles de la version 2, mais peuvent utiliser des noms de champs ou des types d'énumération mis à jour. Dans votre intégration, remplacez les ressources YoutubeAdGroup ou YoutubeAdGroupAd par des ressources AdGroup et AdGroupAd, puis mettez à jour les appels aux services v2 suivants par le service v3 correspondant :
- advertisers.youtubeAdGroupAds vers advertisers.adGroupAds
- advertisers.youtubeAdGroups vers advertisers.adGroups
- advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions vers advertisers.adGroups.targetingTypes.assignedTargetingOptions
Les références aux objets YoutubeAndPartnersBiddingStrategy ont été déplacées vers un nouveau champ youtubeAndPartnersBid dans l'objet BiddingStrategy général. Le champ biddingStrategy a été supprimé de l'objet YoutubeAndPartnersSettings. Mettez à jour votre intégration pour récupérer la stratégie d'enchères des éléments de campagne ou des groupes d'annonces YouTube à partir de l'objet BiddingStrategy dans le champ bidStrategy de la ressource LineItem ou AdGroup.
Le champ thirdPartyMeasurementSettings a été renommé thirdPartyMeasurementConfigs dans l'objet YoutubeAndPartnersSettings et l'objet YoutubeAndPartnersThirdPartyMeasurementSettings a été renommé ThirdPartyMeasurementConfigs. Mettez à jour votre intégration pour récupérer les informations de configuration des mesures tierces à l'aide du nouveau champ et de l'objet.

Inclure les configurations de facturation requises lors de la création d'annonceurs

billingConfig est désormais un champ obligatoire dans la ressource Advertiser. Mettez à jour vos requêtes advertisers.create pour vérifier que ce champ est défini. Les informations de facturation par défaut peuvent être récupérées pour le partenaire parent via le nouveau champ billingConfig de la ressource Partner.

Utiliser un nouveau champ pour contrôler le ciblage optimisé

Un nouveau champ booléen enableOptimizedTargeting a remplacé le champ targetingExpansionLevel dans l'objet TargetingExpansionConfig.

Mettre à jour l'intégration des ordres d'insertion pour utiliser le nouveau champ de KPI

Un nouveau champ kpi a remplacé le champ performanceGoal dans la ressource InsertionOrder. Ce nouveau champ utilise un objet Kpi à la place de l'objet PerformanceGoal, ainsi que de nouveaux champs et énumérations.

Suppression des références aux services et champs obsolètes

Diverses entités ont été supprimées dans la version 3 pour s'aligner sur les anciennes mises à l'abandon de fonctionnalités:

Le service advertisers.manualTriggers a été supprimé, car les déclencheurs manuels sont obsolètes.
Le champ billableOutcome a été supprimé de la ressource InsertionOrder, car l'achat en fonction du résultat est obsolète.

Changements supplémentaires

En plus des modifications non destructives listées ci-dessus, la version 3 introduit également de nouvelles fonctionnalités.

Vous trouverez les fonctionnalités ajoutées à la version 3 après le lancement initial dans nos notes de version.

Gestion de la liste des établissements à proximité

Dans la version 3, vous pouvez gérer entièrement les listes d'emplacements à proximité, ce qui vous permet d'utiliser le service advertisers.locationLists.assignedLocations pour créer et supprimer des emplacements attribués aux ressources TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Les emplacements sont identifiés à l'aide de l'ID des ressources TARGETING_TYPE_POI TargetingOption. Vous pouvez les récupérer à l'aide de targetingTypes.targetingOptions.search.

Possibilité de créer des algorithmes d'enchères personnalisées basés sur des règles

Dans la version 3, vous pouvez créer et récupérer des algorithmes d'enchères personnalisées basés sur des règles à l'aide des services customBiddingAlgorithms, media et customBiddingAlgorithms.rules.

Cette fonctionnalité est en version bêta et n'est disponible que pour les partenaires figurant sur la liste d'autorisation. Si votre partenaire ne figure pas sur la liste d'autorisation, votre requête renvoie une erreur.