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 ne pas proposer plus de cinq versions majeures à la fois.
- Les versions majeures ont une durée de vie d'environ 12 mois, et les versions mineures de 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 de la version (N) directement à 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 ci-dessous 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 à passer à la dernière version dès que possible après son lancement. La date provisoire signifie que l'abandon 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'abandon des versions de l'API.
| Version de l'API | Date de sortie | Date d'abandon | Modifications destructives et mise à niveau | Fonctionnalités et mises à jour | Tableau des différences entre les protos |
|---|---|---|---|---|---|
| Versions publiées | |||||
| v23 | 28 janvier 2026 | Février 2027 | Modifications destructives de la v23 (guide de mise à niveau) | Fonctionnalités et mises à jour de la v23 | Différences entre les protos v22 et v23 |
| v23.1 | 25 février 2026 | Février 2027 | Aucun (version mineure) | Fonctionnalités et mises à jour de la version 23.1 | Différences entre les protos v22 et v23 |
| v23.2 | 25 mars 2026 | Février 2027 | Aucun (version mineure) | Fonctionnalités et mises à jour de la version 23.2 | Différences entre les protos v22 et v23 |
| v23.3 | 24 juin 2026 | Février 2027 | Aucun (version mineure) | Fonctionnalités et mises à jour de la version 23.3 | Différences entre les protos v22 et v23 |
| v24 | 22 avril 2026 | Mai 2027 | Modifications destructives de la v24 (guide de mise à niveau) | Fonctionnalités et mises à jour de la v24 | Différences entre les protos v23 et v24 |
| v24.1 | 13 mai 2026 | Mai 2027 | Aucun (version mineure) | Fonctionnalités et mises à jour de la version 24.1 | Différences entre les protos v23 et v24 |
| v24.2 | 24 juin 2026 | Juin 2027 | Aucun (version mineure) | Fonctionnalités et mises à jour de la version 24.2 | Différences entre les protos v23 et v24 |
| v25 | 22 juillet 2026 | Août 2027 | Modifications destructives de la v25 (guide de mise à niveau) | Fonctionnalités et mises à jour de la v25 | Différences entre les fichiers proto v24 et v25 |
| v25.1 | 19 août 2026 | Août 2027 | Aucun (version mineure) | Fonctionnalités et mises à jour de la version 25.1 | Différences entre les fichiers proto v24 et v25 |
| v25.2 | 23 septembre 2026 | Août 2027 | Aucun (version mineure) | Fonctionnalités et mises à jour de la version 25.2 | Différences entre les fichiers proto v24 et v25 |
| v26 (la plus récente) | 14 octobre 2026 | Novembre 2027 | Modifications destructives de la v26 (guide de mise à niveau) | Fonctionnalités et mises à jour de la v26 | Différences entre les protos v25 et v26 |
| Versions à venir | |||||
| v26.1 | Octobre 2026 | Novembre 2027 | |||
| v26.2 | Novembre 2026 | Novembre 2027 | |||
| v26.3* | Décembre 2026 | Novembre 2027 | |||
| v27 | Janvier 2027 | Février 2028 | |||
| v27.1 | Février 2027 | Février 2028 | |||
| v27.2 | Février 2027 | Février 2028 | |||
| v27.3 | Mars 2027 | Février 2028 | |||
| v27.4 | Mars 2027 | Février 2028 | |||
| v28 | Avril 2027 | Mai 2028 | |||
| v28.1 | Avril 2027 | Mai 2028 | |||
| v28.2 | Mai 2027 | Mai 2028 | |||
| v28.3 | Mai 2027 | Mai 2028 | |||
| v28.4 | Juin 2027 | Mai 2028 | |||
| v28.5 | Juin 2027 | Mai 2028 | |||
| v29 | Juillet 2027 | Août 2028 | |||
| v29.1 | Juillet 2027 | Août 2028 | |||
| v29.2 | Août 2027 | Août 2028 | |||
| v29.3 | Août 2027 | Août 2028 | |||
| v29.4 | Septembre 2027 | Août 2028 | |||
| v29.5 | Septembre 2027 | Août 2028 | |||
| v30 | Octobre 2027 | Novembre 2028 | |||
| v30.1 | Octobre 2027 | Novembre 2028 | |||
| v30.2 | Novembre 2027 | Novembre 2028 | |||
| v30.3* | Décembre 2027 | Novembre 2028 | |||
* Les versions 26.3 et 30.3 sont désignées comme des versions facultatives en raison de leur chevauchement avec la période des fêtes.
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, 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.v26.services.GoogleAdsService.Mutate. - (Facultatif) Choisissez la période que vous souhaitez afficher pour vos demandes.
Différences entre l'abandon et l'arrêt
| Terme | Obsolescence | Coucher du soleil |
|---|---|---|
| Définition | La version obsolète est une version qui n'est pas la plus récente. Lorsqu'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. |
| Implication | Vous pouvez continuer à utiliser les versions obsolètes jusqu'à leur abandon, mais les références des versions obsolètes sont 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 bénéficier des nouvelles fonctionnalités. |
Vous devez immédiatement passer à une version plus récente pour 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 donnée sera donc obsolète après environ trois à quatre mois. | Nous prévoyons d'abandonner 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 de l'API à l'aide de nos bibliothèques clientes et de REST. Toutefois, les nouvelles fonctionnalités ne sont pas ajoutées aux versions obsolètes. |
Les points de terminaison de l'API des versions abandonnées cessent 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 de l'API des versions obsolètes. |
| 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'abandon. Cela vous permet d'économiser de l'espace lorsque vous intégrez nos bibliothèques clientes dans 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 standard pour les versions obsolètes. | Les versions abandonnées ne sont plus compatibles une fois la date d'abandon passée. |
Versions de bibliothèques clientes compatibles
Le tableau indique quelles bibliothèques clientes fonctionnent avec quelles versions de l'API.
La version minimale de la bibliothèque cliente indiquée est suffisante pour la version majeure de l'API Google Ads (par exemple, v26). Pour connaître la version de la bibliothèque cliente requise pour les versions mineures, consultez le journal des modifications associé.
Java
API Google Ads |
Bibliothèque cliente pour Java |
v26 |
Min: 48.0.0Max: - |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
API Google Ads |
Bibliothèque cliente pour .NET |
v26 |
Min: 27.5.0Max: - |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
API Google Ads |
Bibliothèque cliente pour PHP |
v26 |
Min: 35.2.0Max: - |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
API Google Ads |
Bibliothèque cliente pour Python |
v26 |
Min: 34.0.0Max: - |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
API Google Ads |
Bibliothèque cliente pour Ruby |
v26 |
Min: 46.0.0Max: - |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
API Google Ads |
Bibliothèque cliente pour Perl |
v26 |
Min: 36.0.0Max: - |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
Abandons et modifications de fonctionnalités
Cette page se concentre sur les cycles de vie au niveau de la version de l'API. Les abandons de fonctionnalités individuelles (comme l'abandon des campagnes intelligentes) et les modifications de workflow sans version (comme les nouvelles exigences de budget pour les campagnes de génération de la demande) sont suivis séparément.
Pour vérifier les cycles de vie des fonctionnalités à venir et les changements de comportement entre les versions actives, consultez le guide Fonctionnalités obsolètes et modifications sans version.