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:
- 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 apportées à chaque version.
- 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 :
|
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 :
|
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 customervers : 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 .
|