Inscrivez-vous dès aujourd'hui à l'atelier Performance Max et API Google Ads qui se déroulera le 17 juillet.

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

Passer à la dernière version

Vous pouvez régulièrement passer d'une ancienne version majeure de l'API Google Ads à une version majeure plus récente. Cela peut être dû à l'arrêt d'une version ou à l'utilisation d'une nouvelle fonctionnalité. Nous vous recommandons de toujours passer à la version la plus récente.

Consultez notre calendrier d'abandon pour planifier vos mises à niveau. Pour en savoir plus sur son fonctionnement, consultez notre guide de gestion des versions.

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

Votre point de terminaison change lorsque vous changez de version majeure. Mettez à jour vos bibliothèques clientes pour utiliser le point de terminaison le plus récent.
Consultez les notes de version pour voir les modifications introduites dans chaque version.
Consultez les tableaux ci-dessous pour connaître les aspects spécifiques de la version vers laquelle vous effectuez la mise à niveau.

Pour une présentation complète des modifications basées sur les différences entre les fichiers proto des deux versions, consultez le tableau des différences.

v16 à v17

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 d'un 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`. Pour en savoir plus, consultez cet article de blog.
`GoogleAdsService` `Search`.	La transmission d'un `page_size` à `GoogleAdsService.Search` entraîne une erreur `RequestError.PAGE_SIZE_NOT_SUPPORTED`.
`Campaign` et `Ad`	Les campagnes dont l'`AdvertisingChannelType` est de `DISCOVERY` utiliseront désormais un `AdvertisingChannelType` de `DEMAND_GEN`. En outre, le type et le nom des champs de certaines annonces seront modifiés pour la création de 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` sera remplacé par `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` sera remplacé par `ad_group_ad.ad.demand_gen_carousel_ad` `DISCOVERY_VIDEO_RESPONSIVE_AD` deviendra `DEMAND_GEN_VIDEO_RESPONSIVE_AD`, et le champ de rapport correspondant `ad_group_ad.ad.discovery_video_responsive_ad` sera remplacé par `ad_group_ad.ad.demand_gen_video_responsive_ad`
`AdService`	Le point de terminaison `GetAd` sera supprimé. Cela permet d'aligner la valeur `AdService` sur celle des autres services de l'API Google Ads. Consultez notre guide sur la récupération des objets pour connaître la méthode recommandée pour récupérer des 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. Consultez la section Segmenter vos audiences de la documentation sur les objectifs de cycle de vie pour obtenir une vue d'ensemble complète.
`ProductLink`	Lorsque vous exécutez une requête de flux de recherche ou de recherche `GoogleAdsService` pour `product_link`, vous ne pouvez désormais sélectionner que les champs liés à un produit associé. Si vous sélectionnez plusieurs champs de différents produits associés, une erreur `QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE` est générée.
Fréquence	Remplacement du nom du champ `metrics.sk_ad_network_conversion_value` par `metrics.sk_ad_network_fine_conversion_value`.

v15 à v16

Modifications apportées aux services et à leurs composants
`AccountLink`	Les liens `data_partner` et `google_ads` dans `linked_account` ont été supprimés. Utilisez `ProductLinkService` et `ProductLinkInvitationService` à la place.
`CampaignLifecycleGoal`	Lors de la mise à jour précédente d'une `CampaignLifecycleGoal` existante, vous deviez exécuter une opération `create` avec des exigences spécifiques. Vous pouvez maintenant exécuter une opération `update` comme pour les autres types de ressources.
Les rapports d'erreur	Les deux cas où l'erreur générique `ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT` a été renvoyée entraînent désormais des messages d'erreur plus spécifiques : `CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT` `CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS`
`AudienceInsightsAttributeMetadata`	Le champ `score` a été supprimé.
`KeywordMatchTypeRecommendation`	Si le type de correspondance des mots clés n'est pas défini, l'API renvoie désormais `UNSPECIFIED` au lieu de `UNKNOWN` pour le champ `recommended_match_type`.

v14 à v15

Modifications apportées aux services et à leurs composants
`AssetGroupListingGroupFilter`	Le champ d'énumération `vertical` a été renommé `feed_type`.
`MediaFileService`	Le service a été supprimé, car il n'est plus nécessaire. Consultez la modification de `ImageAdInfo` ci-dessous.
`ImageAdInfo`	Le champ `media_file` a été remplacé par `image_asset`.
`MerchantCenterLinkService`	Ce service a été remplacé par `ProductLinkInvitationService` et `ProductLinkService`.
`Campaign.ShoppingSetting`	Le champ `sales_country` a été supprimé. Les informations sont maintenant renvoyées dans le champ `feed_label`.
`ProductBiddingCategoryConstant`	Remplacé par `ProductCategoryConstant`. Plusieurs champs ont été renommés en conséquence. Reportez-vous aux trois modifications suivantes ci-dessous.
`ListingDimensionInfo`	Remplacement du champ `product_bidding_category` par `product_category`.
`ListingGroupFilterDimension`	Remplacement du champ `product_bidding_category` par `product_category`.
Rapport `shopping_performance_view`	Les champs de segment suivants : `product_bidding_category_level1` `product_bidding_category_level2` `product_bidding_category_level3` `product_bidding_category_level4` `product_bidding_category_level5` ont été remplacées par : `product_category_level1` `product_category_level2` `product_category_level3` `product_category_level4` `product_category_level5`
`Campaign.shopping_setting`	Il n'est plus possible de créer des campagnes sur le Réseau de Recherche avec ce champ.
`CampaignCriterion.listing_scope`	Il n'est plus possible de créer des campagnes sur le Réseau de Recherche avec ce champ.
Rapport `sk_ad_network_conversions`	`metrics.sk_ad_network_conversions` a été remplacé par `metrics.sk_ad_network_installs`.
`OfflineConversionClientSummary`	Déplacement du champ `offline_conversion_client_summaries` de `Customer` vers une ressource de niveau supérieur que vous pouvez interroger séparément. Remplacez votre requête par: SELECT customer.offline_conversion_client_summaries FROM customer au SELECT offline_conversion_upload_client_summary.client, offline_conversion_upload_client_summary.status, offline_conversion_upload_client_summary.total_event_count, offline_conversion_upload_client_summary.successful_event_count, offline_conversion_upload_client_summary.last_upload_date_time, ... FROM offline_conversion_upload_client_summary Utilisez le générateur de requêtes pour explorer la liste des champs disponibles pour la sélection et le filtrage.
`OfflineConversionUploadAlert`	Nouveau nom : `OfflineConversionAlert`.
`OfflineConversionUploadError`	Nouveau nom : `OfflineConversionError`.
`AdNetworkType`	Les énumérations `YOUTUBE_SEARCH` et `YOUTUBE_WATCH` ont été fusionnées en une seule énumération : `YOUTUBE`.