Abandon et arrêt

Lorsque nous publions une nouvelle version, nous attribuons à une version obsolète une date d'abandon après laquelle elle ne sera plus disponible. Voici quelques autres consignes à garder à l'esprit:

• Au maximum, trois versions majeures sont disponibles à la fois.
• Les versions majeures ont une durée de vie d'environ 12 mois. Les versions mineures: 10 mois.
• Vous devrez effectuer au maximum deux mises à niveau par an, et vous n'avez pas besoin de les effectuer dans un ordre séquentiel strict. Par exemple, vous pouvez passer directement de la version (N) à la version (N+2).
• Le chevauchement entre la date de publication de toutes les bibliothèques clientes pour la dernière version et la date d'arrêt de la version est d'au moins 20 semaines.

Nos bibliothèques clientes sont compatibles avec toutes les versions disponibles d'un service. Vous pouvez donc effectuer une mise à niveau progressive en spécifiant différentes versions des services utilisés.

Horaires

Le tableau suivant répertorie les dates d'abandon et d'abandon spécifiques à chaque version disponible, ainsi que les dates de sortie prévues pour les futures versions. Nous vous encourageons à passer à la dernière version dès que possible après son lancement.

Version de l'API	Date de sortie	Début de la période d'abandon	Date d'abandon	Guide de migration
v18	16 octobre 2024	Février 2025	24 septembre 2025
v17.1	7 août 2024	Sept./Oct. 2024	4 juin 2025	Passer de la version 17 à la version 18
v17	5 juin 2024	Sept./Oct. 2024	4 juin 2025	Passer de la v17 à la v18
v16.1	24 avril 2024	5 juin 2024	5 février 2025	Passer de la v16 à la v17
v16	21 février 2024	5 juin 2024	5 février 2025	Passer de la version 16 à la version 17

Afficher les versions utilisées par votre projet

Vous pouvez afficher la liste des méthodes et services récemment appelés par votre projet à l'aide de la console Google Cloud:

1. Ouvrez la page API et services dans la console Google Cloud.
2. Cliquez sur API Google Ads dans le tableau.
3. Dans le sous-onglet MÉTRIQUES, vos requêtes récentes doivent s'afficher sur chaque graphique. Vous pouvez voir à quelles méthodes vous avez envoyé des requêtes dans la table Méthodes. Le nom de la méthode inclut une version de l'API Google Ads, un service et un nom de méthode, par exemple google.ads.googleads.v18.services.GoogleAdsService.Mutate.
4. (Facultatif) Sélectionnez la période pendant laquelle vous souhaitez afficher vos requêtes.

Différences entre abandon et arrêt

Terme	Obsolescence	Coucher de soleil
Définition	La version obsolète est une version qui n'est pas la dernière. Lorsqu'une nouvelle version sera publiée, toutes les versions précédentes seront marquées comme obsolètes.	La version abandonnée ne peut plus être utilisée. Les requêtes envoyées à cette version échoueront à la date d'arrêt ou après cette date.
Implication	Vous pouvez toujours utiliser les versions obsolètes jusqu'à leur abandon, mais les références des versions obsolètes ne sont plus mises en surbrillance pour indiquer qu'elles ne sont plus les dernières versions. Nous vous encourageons à passer à la dernière version dès que possible pour profiter des nouvelles fonctionnalités.	Vous devez passer immédiatement à ces versions pour pouvoir utiliser l'API Google Ads. Nous vous recommandons vivement de passer à la dernière version à l'aide du guide de mise à niveau.
Durée	En moyenne, nous publions une nouvelle version tous les trois à quatre mois. La version donnée sera donc abandonnée au bout d'environ trois à quatre mois.	Nous prévoyons d'arrêter une version un an après sa sortie.
API	Les points de terminaison de l'API pour les versions obsolètes fonctionnent toujours comme d'habitude. Vous pouvez accéder à nos points de terminaison d'API à l'aide de nos bibliothèques clientes, de REST, etc. Toutefois, les nouvelles fonctionnalités ne sont pas ajoutées aux versions obsolètes.	Les points de terminaison d'API des versions abandonnées cessent de fonctionner après les dates d'abandon. L'API Google Ads génère une erreur si vous essayez d'accéder aux points de terminaison de l'API dans les versions arrêtées.
Bibliothèques clientes	Afin de fournir des bibliothèques clientes compactes, nous cesserons d'inclure les versions obsolètes de l'API dans une nouvelle version de la bibliothèque cliente après la date d'abandon. Vous pouvez ainsi économiser de l'espace lorsque vous incorporez nos bibliothèques clientes à vos projets.	Les bibliothèques clientes ne sont plus compatibles avec les versions d'API abandonnées dans les nouvelles versions de bibliothèques clientes après les dates d'abandon.
Assistance	Nous fournissons une assistance régulière pour les versions obsolètes.	Les versions abandonnées ne sont plus acceptées après la date d'arrêt.

Versions compatibles des bibliothèques clientes

Le tableau indique les bibliothèques clientes compatibles avec les versions d'API.

Abandons de fonctionnalités

Consultez régulièrement le blog des développeurs Google Ads pour être le premier informé de l'abandon à venir des fonctionnalités.

Le tableau suivant répertorie les abandons de fonctionnalités spécifiques qui sont actuellement prévus pour l'API Google Ads. Pour en savoir plus sur chaque abandon, consultez les articles de blog associés.

Fonctionnalité	Description	Date d'entrée en vigueur	Remarques supplémentaires
Modifications à venir concernant la taille des pages dans l'API Google Ads	Lorsque la version 16 sera arrêtée, vous ne pourrez plus définir le champ page_size lorsque vous effectuerez des requêtes GoogleAdsService.Search.	Janvier 2025	Lorsque la version 16 sera abandonnée, la taille des pages sera fixée à 10 000 lignes pour toutes les requêtes GoogleAdsService.Search.
Stratégie d'enchères "CPC optimisé"	L'API Google Ads ne permet plus de définir l'eCPC en tant que stratégie d'enchères pour les campagnes sur les Réseaux de Recherche et Display.	Octobre 2024	Les requêtes visant à définir le champ enhanced_cpc_enabled sur TRUE dans une stratégie d'enchères entraîneront une erreur BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Les campagnes existantes utilisant la stratégie d'enchères au CPC optimisé continueront d'être diffusées jusqu'au 15 mars 2025. Passé cette date, elles seront automatiquement migrées vers les enchères au coût par clic (CPC) manuelles.