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 |
GoogleAdsService
Search . |
La transmission d'un |
Campaign et Ad |
Les campagnes dont l' En outre, le type et le nom des champs de certaines annonces seront modifiés pour la création de rapports:
|
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 :
|
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 :
|
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 customerau 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 .
|