Migrer de la version 3 à la version 4

Dernière mise à jour : 31-07-2025

Migrer votre application

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

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

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

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

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

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

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

Apporter les modifications requises

Nous introduisons un certain nombre de changements incompatibles dans la version 4. 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 concernant les ressources d'audience propriétaires et tierces, ainsi que le ciblage associé

Les ressources FirstAndThirdPartyAudience ont été remplacées par des ressources FirstPartyAndPartnerAudience.

Cette modification nécessite que vous mettiez à jour les éléments suivants :

• Références aux ressources FirstAndThirdPartyAudience pour utiliser la nouvelle ressource FirstPartyAndPartnerAudience.
• Les requêtes existantes adressées aux méthodes du service v3 firstAndThirdPartyAudiences vers le nouveau service v4 firstPartyAndPartnerAudiences.
• Attentes concernant la taille de page par défaut pour les requêtes firstPartyAndPartnerAudiences.list de 100 à 5 000 éléments.
• Références au champ firstAndThirdPartyAudienceType de la version 3 vers le nouveau champ firstPartyAndPartnerAudienceType de la version 4, à l'aide du nouveau type d'énumération FirstPartyAndPartnerAudienceType, avec les anciennes valeurs correspondant aux nouvelles valeurs suivantes :
  • De FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY à TYPE_FIRST_PARTY
  • De FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY à TYPE_PARTNER

• Références à la valeur d'énumération AudienceType LICENSED pour utiliser à la place l'une des nouvelles valeurs plus spécifiques suivantes :

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Références aux ressources AssignedTargetingOption de TargetingType TARGETING_TYPE_AUDIENCE_GROUP pour remplacer les champs v3 dans AudienceGroupAssignedTargetingOptionDetails par les nouveaux champs v4 suivants :

  • excludedFirstAndThirdPartyAudienceGroup avec excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups avec includedFirstPartyAndPartnerAudienceGroups

Modifier les demandes de ciblage par liste groupée de groupes d'annonces existantes

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions a été renommé advertisers.adGroups.bulkListAssignedTargetingOptions. Mettez à jour vos requêtes existantes pour qu'elles utilisent le nouveau nom de méthode.

Inclure un objectif d'optimisation lors de la création d'ordres d'insertion

optimizationObjective est désormais un champ obligatoire dans la ressource InsertionOrder. Mettez à jour vos requêtes advertisers.insertionOrders.create pour vérifier que ce champ est défini.

Supprimer les références au champ de ressource de création publisherReviewStatuses

Le champ publisherReviewStatuses a été supprimé de l'objet ReviewStatusInfo sous la ressource Creative après avoir été déprécié en juin 2024.