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 à garder à l'esprit :
- Nous nous efforçons de maintenir au maximum cinq versions majeures disponibles à tout moment.
- Les versions majeures ont une durée de vie d'environ 12 mois , contre 10 mois pour les versions mineures.
- Vous devrez effectuer au maximum deux mises à niveau par an, et vous n'êtes pas obligé de les effectuer dans un ordre séquentiel strict. Par exemple, vous pouvez passer directement de la version (N) à la version (N+2).
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 de début de la période d'abandon et d'abandon définitif pour chaque version disponible, ainsi que les dates de sortie prévues pour les versions futures. Nous vous encourageons à passer à la dernière version dès que possible après sa sortie. La date provisoire signifie que l'abandon définitif 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 les annonces d'abandon définitif des versions d'API.
| Version de l'API | Date de sortie | Date d'abandon | Guide de migration |
|---|---|---|---|
| Versions publiées | |||
| v21 | 6 août 2025 | Août 2026 (provisoire) | Passer de la version 20 à la version 21 |
| v22 | 15 octobre 2025 | Octobre 2026 (provisoire) | Passer de la version 21 à la version 22 |
| v23 | 28 janvier 2026 | Février 2027 | Passer de la version 22 à la version 23 |
| v23.1 | 25 février 2026 | Février 2027 | Passer de la version 23 à la version 23.1 |
| v23.2 | 25 mars 2026 | Février 2027 | Passer de la version 23.1 à la version 23.2 |
| v24 | 22 avril 2026 | Mai 2027 | Passer de la version 23.2 à la version 24 |
| v24.1 | 13 mai 2026 | Mai 2027 | Passer de la version 24 à la version 24.1 |
| v24.2 | 24 juin 2026 | Juin 2027 | Passer de la version 24.1 à la version 24.2 |
| Versions à venir | |||
| v25 | Juillet 2026 | Août 2027 | |
| v25.1 | Août 2026 | Août 2027 | |
| v25.2 | Septembre 2026 | Août 2027 | |
| v26 | Octobre 2026 | Novembre 2027 | |
| v26.1* | Novembre 2026 | Novembre 2027 | |
* La version 26.1 est désignée comme version facultative en raison de son chevauchement avec la période des fêtes de fin d'année.
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 API et services dans la console Google Cloud.
- Cliquez sur API Google Ads dans le tableau.
- Dans le sous-onglet MÉTRIQUES, vous devriez voir vos requêtes récentes 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.v24.services.GoogleAdsService.Mutate. - (Facultatif) Choisissez la période que vous souhaitez afficher pour vos requêtes.
Différences entre l'obsolescence et l'abandon définitif
| Terme | Obsolescence | Abandon définitif |
|---|---|---|
| Définition | La version obsolète 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'abandon définitif. |
| Implication | Vous pouvez toujours utiliser les versions obsolètes jusqu'à leur abandon définitif,
mais les références des versions obsolètes sont mises en évidence pour indiquer
qu'elles ne sont plus la dernière version.
Nous vous encourageons à passer à la dernière version dès que possible pour bénéficier des nouvelles fonctionnalités. |
Vous devez passer immédiatement des versions abandonnées
pour pouvoir utiliser l'API Google Ads.
Nous vous recommandons vivement de passer à la dernière version à l'aide du guide de migration. |
| Durée | En moyenne, nous publions une nouvelle version tous les trois à quatre mois. La version donnée sera donc obsolète après environ trois à quatre mois. | Nous visons à abandonner définitivement une version un an après sa sortie. |
| API | Les points de terminaison d'API pour les versions obsolètes continuent de fonctionner
normalement.
Vous pouvez accéder à nos points de terminaison d'API à l'aide de nos bibliothèques clientes et de REST. Toutefois, aucune nouvelle fonctionnalité n'est ajoutée aux versions obsolètes. |
Les points de terminaison d'API pour les versions abandonnées cessent de fonctionner après les dates d'abandon définitif. L'API Google Ads générera une erreur si vous tentez 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èque cliente après les dates d'abandon définitif. |
| 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 de bibliothèque cliente compatibles
Le tableau indique les bibliothèques clientes qui fonctionnent avec les versions d'API.
La version minimale de la bibliothèque cliente indiquée est suffisante pour la version majeure de l'API Google Ads (par exemple, la version 24). Pour connaître la version requise de la bibliothèque cliente pour les versions mineures, consultez le journal des modifications associé.
Java
API Google Ads |
Bibliothèque cliente pour Java |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
v22 |
Min: 41.0.0Max: - |
v21 |
Min: 39.0.0Max: - |
C#
API Google Ads |
Bibliothèque cliente pour .NET |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
v22 |
Min: 24.1.0Max: - |
v21 |
Min: 24.0.0Max: - |
PHP
API Google Ads |
Bibliothèque cliente pour PHP |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
v22 |
Min: 31.0.0Max: - |
v21 |
Min: 28.0.0Max: - |
Python
API Google Ads |
Bibliothèque cliente pour Python |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
v22 |
Min: 28.1.0Max: - |
v21 |
Min: 28.0.0Max: - |
Ruby
API Google Ads |
Bibliothèque cliente pour Ruby |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
v22 |
Min: 36.0.0Max: - |
v21 |
Min: 35.0.0Max: - |
Perl
API Google Ads |
Bibliothèque cliente pour Perl |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
v22 |
Min: 29.0.0Max: - |
v21 |
Min: 28.0.0Max: - |
Obsolescence et modifications des fonctionnalités
Bien que cette page se concentre sur les cycles de vie au niveau des versions d'API, l'obsolescence des fonctionnalités individuelles (telles que l'obsolescence des campagnes intelligentes) et les modifications de workflow sans version (telles que les nouvelles exigences de budget de la campagne Demand Gen) sont suivies séparément.
Pour connaître les cycles de vie à venir des fonctionnalités et les changements de comportement dans les versions actives, consultez le guide Obsolescence des fonctionnalités et modifications sans version.