Pour chaque nouvel élément de campagne, vous devez indiquer s'il diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et de l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour en savoir plus, consultez notre page sur les abandons.

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

La migration de la version 2 vers la version 3 nécessite de mettre à jour vos URL de point de terminaison pour appeler la version 3 et de mettre à jour votre application pour qu'elle tienne compte des modifications destructives.

Mettre à jour vos appels d'API de la version 2 vers la version 3

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 deviez utiliser l'URL suivante :

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

Pour la version 3, mettez à jour l'URL comme suit :

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 introduisons un certain nombre de modifications majeures dans la version 3. Consultez les instructions suivantes et apportez les modifications nécessaires en fonction de votre utilisation actuelle de l'API Display & Video 360.

Mettre à jour les appels récupérant 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 des ressources v2, mais peuvent utiliser des noms de champs ou des types d'énumération mis à jour. Dans votre intégration, remplacez vos utilisations des ressources YoutubeAdGroup ou YoutubeAdGroupAd par les ressources AdGroup et AdGroupAd, et mettez à jour les appels aux services v2 suivants vers le service v3 correspondant :
- advertisers.youtubeAdGroupAds à advertisers.adGroupAds
- advertisers.youtubeAdGroups à advertisers.adGroups
- advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions à 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 de mesure tierce à l'aide du nouveau champ et du nouvel 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 de ressource Partner billingConfig.

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 et utilise de nouveaux champs et énumérations.

Supprimer les 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 fonctionnalités obsolètes :

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 basé sur les résultats est obsolète.

Changements supplémentaires

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

Les fonctionnalités ajoutées à la version 3 après le lancement initial sont disponibles dans nos notes de version.

Gérer les listes de proximité

Dans la version 3, vous pouvez gérer entièrement les listes d'emplacements de proximité. Vous pouvez ainsi utiliser le service advertisers.locationLists.assignedLocations pour créer et supprimer des emplacements attribués aux ressources LocationList de TARGETING_LOCATION_TYPE_PROXIMITY. Les lieux 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és 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 ajoutés à la liste d'autorisation. Si votre partenaire n'est pas sur la liste d'autorisation, votre demande renverra une erreur.