Lorsque nous publions une nouvelle version, nous attribuons une date d'abandon définitif à l'ancienne version désormais obsolète, après laquelle elle ne sera plus disponible. Voici quelques autres consignes à retenir :
- Nous nous efforçons de proposer au maximum quatre versions majeures à la fois.
- La durée de vie des versions majeures est d'environ 12 mois, et celle des versions mineures de 10 mois.
- Vous devrez effectuer au maximum deux mises à niveau par an. 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 version à abandonner 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 la date de début de la période d'abandon et la date d'abandon définitif pour chaque version disponible, ainsi que les dates de sortie prévues pour les futures versions. Nous vous encourageons à migrer vers la dernière version dès que possible après son lancement. La date provisoire signifie que l'arrêt peut avoir lieu à tout moment au cours de ce mois et que les dates peuvent changer. Abonnez-vous au blog pour recevoir des rappels concernant l'arrêt des versions de l'API.
| Version de l'API | Date de sortie | Début de la période d'abandon | Date d'abandon | Guide de migration |
|---|---|---|---|---|
| v21 | 6 août 2025 | Mise à niveau de la version 20 vers la version 21 | ||
| v20.1 | 6 août 2025 | Juin 2026 (date provisoire) | Mise à niveau de la version 19 vers la version 20 | |
| v20 | 4 juin 2025 | Juin 2026 (date provisoire) | Mise à niveau de la version 19 vers la version 20 | |
| v19.2 | 6 août 2025 | Février 2026 (date provisoire) | Mise à niveau de la version 18 vers la version 19 | |
| v19.1 | 16 avril 2025 | Février 2026 (date provisoire) | Mise à niveau de la version 18 vers la version 19 | |
| v19 | 26 février 2025 | Février 2026 (date provisoire) | Mise à niveau de la version 18 vers la version 19 | |
| v18 | 16 octobre 2024 | Juin 2025 | 20 août 2025 |
Afficher les versions utilisées par votre projet
Vous pouvez afficher la liste des méthodes et des services que votre projet a récemment appelés à l'aide de la console Google Cloud :
- Ouvrez la page API et services dans la console Google Cloud.
- Cliquez sur API Google Ads dans le tableau.
- Dans le sous-onglet MÉTRIQUES, vos requêtes récentes devraient être représentées sur chaque graphique. Vous pouvez voir les méthodes auxquelles vous avez envoyé des requêtes dans le tableau 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.v21.services.GoogleAdsService.Mutate. - (Facultatif) Choisissez la période pour laquelle vous souhaitez afficher vos demandes.
Différences entre l'arrêt et l'abandon
| Terme | Obsolescence | Coucher de soleil |
|---|---|---|
| Définition | Une version obsolète est une version qui n'est pas la dernière. Une fois qu'une nouvelle version est publiée, toutes les versions précédentes sont marquées comme obsolètes. | La version abandonnée ne peut plus être utilisée. Les requêtes envoyées à cette version échoueront à partir de la date d'arrêt. |
| Implication | Vous pouvez continuer à utiliser les versions obsolètes jusqu'à leur arrêt. Toutefois, les références de ces versions ne sont plus mises en évidence 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 immédiatement effectuer la mise à niveau à partir des versions abandonnées pour pouvoir utiliser l'API Google Ads.
Nous vous recommandons vivement de passer à la dernière version en suivant le guide de mise à niveau. |
| Durée | En moyenne, nous publions une nouvelle version tous les trois à quatre mois. La version indiquée sera donc obsolète au bout de trois à quatre mois environ. | Nous prévoyons d'abandonner une version un an après sa sortie. |
| API | Les points de terminaison d'API pour les versions obsolètes fonctionnent toujours normalement.
Vous pouvez accéder à nos points de terminaison d'API à l'aide de nos bibliothèques clientes, de REST, etc. Toutefois, aucune nouvelle fonctionnalité n'est ajoutée aux versions obsolètes. |
Les points de terminaison d'API pour les versions abandonnées cesseront de fonctionner après les dates d'abandon. L'API Google Ads générera une erreur si vous essayez d'accéder aux points de terminaison d'API des versions abandonnées. |
| Bibliothèques clientes | Afin de fournir des bibliothèques clientes compactes, nous cesserons d'inclure les versions d'API obsolètes dans une nouvelle version de bibliothèque cliente après la date d'obsolescence. Cela vous permet de gagner de l'espace lorsque vous intégrez 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 compatibles une fois la date d'abandon passée. |
Versions des bibliothèques clientes compatibles
Le tableau indique les bibliothèques clientes compatibles avec les différentes versions de l'API.
Java
API Google Ads |
Bibliothèque cliente pour Java |
v21 |
Min: 39.0.0Max: - |
v20 |
Min: 38.0.0Max: - |
v19 |
Min: 36.0.0Max: - |
C#
API Google Ads |
Bibliothèque cliente pour .NET |
v21 |
Min: 24.0.0Max: - |
v20 |
Min: 23.0.0Max: - |
v19 |
Min: 22.1.0Max: - |
v18 |
Min: 21.1.0Max: 23.0.0 |
PHP
API Google Ads |
Bibliothèque cliente pour PHP |
v21 |
Min: 31.0.0Max: - |
v20 |
Min: 28.0.0Max: - |
v19 |
Min: 26.1.0Max: - |
v18 |
Min: 25.0.0Max: 30.0.0 |
Python
API Google Ads |
Bibliothèque cliente pour Python |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 27.0.0Max: - |
v19 |
Min: 25.2.0Max: - |
Ruby
API Google Ads |
Bibliothèque cliente pour Ruby |
v21 |
Min: 35.0.0Max: - |
v20 |
Min: 34.0.0Max: - |
v19 |
Min: 32.0.0Max: - |
v18 |
Min: 31.0.0Max: - |
Perl
API Google Ads |
Bibliothèque cliente pour Perl |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 27.0.0Max: - |
v19 |
Min: 26.0.0Max: - |
v18 |
Min: 25.0.1Max: 28.0.0 |
Abandons de fonctionnalités
Consultez régulièrement le blog dédié aux développeurs Google Ads pour être informé des futures obsolescences de fonctionnalités.
Le tableau suivant répertorie les fonctionnalités spécifiques qui seront bientôt obsolètes dans l'API Google Ads. Pour en savoir plus sur chaque abandon, consultez les articles de blog correspondants.
| Fonctionnalité | Description | Date d'entrée en vigueur | Remarques supplémentaires |
|---|---|---|---|
| Environnement de conversion ayant une incidence sur les performances des campagnes pour applications | À partir du 30 septembre 2025, nous commencerons à déployer progressivement une modification des modèles d'enchères. Ils pourront ainsi utiliser les données sur l'environnement de conversion incluses dans les conversions importées pour optimiser les performances des campagnes. | 3 octobre 2025 | Pour en savoir plus, consultez notre article de blog. |
| Les conversions peuvent inclure à la fois des valeurs "gclid" et "gbraid". | À partir du 3 octobre 2025, les conversions importées ne renverront plus d'erreur `VALUE_MUST_BE_UNSET` si les champs `gclid` et `gbraid` sont tous les deux définis. | 3 octobre 2025 | Pour en savoir plus, consultez notre article de blog. |