Passer à la dernière version

Vous pouvez être amené, de temps à autre, à effectuer une mise à niveau à partir d'une ancienne version majeure de l'API Google Ads vers une version majeure plus récente. C'est peut-être parce qu'une version est en cours d'arrêt, ou parce que vous voulez utiliser une nouvelle fonctionnalité. Nous vous recommandons de toujours passer à la dernière version.

Consultez le planning d'abandon pour planifier votre des mises à niveau. Pour savoir comment procéder, consultez notre guide de gestion des versions. la gestion des versions fonctionne.

Voici une checklist pour vous aider à démarrer le processus de migration :

  1. Votre point de terminaison change lorsque vous changez de version majeure. Mettez à jour votre bibliothèques clientes pour utiliser le point de terminaison le plus récent.
  2. Consultez les notes de version pour voir les modifications apportées à chaque version.
  3. Consultez les tableaux ci-dessous pour connaître les domaines spécifiques sur lesquels se concentrer pour cette version vers lequel vous effectuez la mise à niveau.

Pour un aperçu complet des modifications basées sur la différence entre les protos de les deux versions, consultez le tableau des différences.

v17 à v18

Modifications apportées aux services et à leurs composants
GoogleAdsService Requêtes Search et SearchStream

L'erreur lorsque votre requête est limitée en raison de son coût trop élevé sera QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION ou QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION au lieu de QuotaError.RESOURCE_EXHAUSTED. Voir le blog .
GoogleAdsService Les champs summary_row_setting et return_total_results_count de SearchGoogleAdsRequest font désormais partie du nouvel objet SearchSettings.
AssetType La valeur d'énumération DISCOVERY_CAROUSEL_CARD a été renommée DEMAND_GEN_CAROUSEL_CARD. Cette modification s'inscrit dans la continuité d'un changement précédent qui a consisté à renommer les campagnes Discovery en campagnes de génération de la demande.
AudienceInsightsService.GenerateSuggestedTargetingInsights audience, baseline_audience et data_month champs ont été déplacés dans le audience_definition.
DemandGenCampaignSettings La valeur par défaut du champ upgraded_targeting est désormais true au lieu de false.
LocalServicesLeadConversation Le champ phone_call_details.call_recording_url ne sera plus renseigné pour les appels statiques.

de la version 16 à la version 17

Modifications apportées aux services et à leurs composants
GoogleAdsService Requêtes Search et SearchStream

Votre requête peut être limitée si la requête est trop coûteuse. Si c'est le cas, vous obtenez une erreur QuotaError.RESOURCE_EXHAUSTED. Voir le blog .
GoogleAdsService Search requêtes.

Transmettre un page_size à GoogleAdsService.Search génère une erreur RequestError.PAGE_SIZE_NOT_SUPPORTED.
Campaign et Ad

Campagnes avec un AdvertisingChannelType de DISCOVERY aura désormais un AdvertisingChannelType de DEMAND_GEN à la place.

De plus, le type et les noms de champs de certaines annonces seront modifiés pour les rapports :

  • DISCOVERY_MULTI_ASSET_ADD deviendra DEMAND_GEN_MULTI_ASSET_ADD et le champ de rapport correspondant ad_group_ad.ad.discovery_multi_asset_ad va devenir ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD deviendra DEMAND_GEN_CAROUSEL_AD et le champ de rapport correspondant ad_group_ad.ad.discovery_carousel_ad va devenir ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD deviendra DEMAND_GEN_VIDEO_RESPONSIVE_AD et le champ de création de rapports correspondant ad_group_ad.ad.discovery_video_responsive_ad deviendra ad_group_ad.ad.demand_gen_video_responsive_ad.
AdService Le point de terminaison GetAd sera supprimé. Ainsi, AdService conformément à d'autres services de l'API Google Ads. Consultez nos sur la récupération des objets pour connaître la méthode recommandée pour extraire les annonces et d'autres types de ressources.
CustomerLifecycleGoal et CampaignLifecycleGoal Nous repensons la façon dont vous gérez les segments pour les objectifs de cycle de vie. Pour en savoir plus, consultez la section Segmenter vos audiences de la documentation sur les objectifs de cycle de vie.
ProductLink Lorsque vous exécutez une recherche ou un flux de recherche GoogleAdsService pour product_link, vous ne pouvez désormais sélectionner que des champs liés à un produit associé. Sélectionner plusieurs champs à partir de différents produits associés se traduira par une QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE .
Rapports Remplacement du nom du champ metrics.sk_ad_network_conversion_value par metrics.sk_ad_network_fine_conversion_value