Passer de la v2 à la v3

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

Migrer votre application

La migration de la version 2 à la version 3 nécessite la mise à jour de vos URL de point de terminaison pour appeler la version 3 et et de mettre à jour votre application pour tenir compte des modifications destructives.

Mettre à jour vos appels d'API de la version 2 à 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 la nouvelle version v3 les points de terminaison.

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

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

Pour la version 3, modifiez 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 méthode version récente de la bibliothèque cliente et mettez à jour votre configuration pour qu'elle utilise la version 3.

Apporter les modifications requises

Nous apportons un certain nombre de modifications importantes dans la v3. Passez en revue les éléments suivants instructions et d'apporter les modifications nécessaires à votre utilisation actuelle du Display & l'API Video 360.

Modifier les appels récupérant des ressources YouTube et leur ciblage associé

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

Inclure les configurations de facturation requises lorsque vous créez des annonceurs

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

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

Un nouveau champ booléen enableOptimizedTargeting a remplacé le Champ targetingExpansionLevel dans le TargetingExpansionConfig .

Mettre à jour l'intégration de l'ordre 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 Kpi à la place de l'objet PerformanceGoal et utilise de nouveaux champs et énumérations.

Supprimer les références aux services et aux champs obsolètes

Différentes entités ont été supprimées dans la version 3 pour s'aligner sur les anciennes fonctionnalités. abandons:

• Le service advertisers.manualTriggers n'est plus considéré comme un déclencheur manuel. ont été abandonnés.
• Le champ billableOutcome a été supprimé de La ressource InsertionOrder, car les achats en fonction du résultat ont été obsolète.

Changements supplémentaires

En plus des modifications destructives répertoriées ci-dessus, la version 3 introduit de nouveaux caractéristiques.

Les fonctionnalités ajoutées à la version 3 après le lancement initial sont disponibles dans notre version commentaires.

Gestion des listes d'emplacements de proximité

Dans la version 3, vous pouvez gérer entièrement les listes de zones géographiques de proximité, ce qui vous permet de : utilisez le service advertisers.locationLists.assignedLocations pour créer et supprimer les zones géographiques attribuées à TARGETING_LOCATION_TYPE_PROXIMITY Ressources : LocationList Les zones géographiques sont identifiées à l'aide de l'identifiant TARGETING_TYPE_POI TargetingOption. Il peut s'agir récupérée à 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 de la customBiddingAlgorithms, media 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 ne figure pas sur la liste d'autorisation, votre demande renverra une erreur.