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'abandon d'une version, ou à l'utilisation d'une nouvelle fonctionnalité. Nous vous recommandons de toujours passer à la version la plus récente.

Consultez notre planning d'abandon pour planifier vos mises à niveau. Consultez notre guide de gestion des versions pour en savoir plus sur le fonctionnement de cette fonctionnalité.

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

  1. 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.
  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 sur lesquels vous devez vous concentrer pour 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 prototypes des deux versions, consultez le tableau des différences.

v15 à v16

Modifications apportées aux services et à leurs composants
AccountLink Les associations data_partner et google_ads dans linked_account ont été supprimées. Utilisez plutôt ProductLinkService et ProductLinkInvitationService.
CampaignLifecycleGoal Lors de la mise à jour d'un CampaignLifecycleGoal existant, vous devez émettre une opération create avec des exigences spécifiques. Vous pouvez maintenant émettre une opération update comme pour les autres types de ressources.
Error Reporting 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 Le 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. Consultez les 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 Remplacement de metrics.sk_ad_network_conversions 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
vers : 
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 Changement de nom : OfflineConversionAlert.
OfflineConversionUploadError Changement de nom : OfflineConversionError.
AdNetworkType Les énumérations YOUTUBE_SEARCH et YOUTUBE_WATCH ont été fusionnées en une seule énumération : YOUTUBE.