Abandon et arrêt

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, tandis que les versions mineures ont une durée de vie 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'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'abandon des versions de l'API.

Version de l'APIDate de sortieDate d'abandonGuide de migration
Versions publiées
v2215 octobre 2025Octobre 2026Mise à niveau de la version 21 vers la version 22
v2328 janvier 2026Février 2027Passer de la v22 à la v23
v23.1 25 février 2026 Février 2027 Passer de la v23 à la v23.1
v23.2 25 mars 2026 Février 2027 Mise à niveau de la version 23.1 vers la version 23.2
v24 22 avril 2026 Mai 2027 Mise à niveau de la version 23.2 vers la version 24
v24.1 13 mai 2026 Mai 2027 Mise à niveau de la version 24 vers la version 24.1
v24.2 24 juin 2026 Juin 2027 Passer de la version 24.1 à la version 24.2
v25 22 juillet 2026 Août 2027 Passer de la v24.2 à la v25
v25.1 19 août 2026 Août 2027 Passer de la v25 à la v25.1
v25.2 23 septembre 2026 Août 2027 Mise à niveau de la version 25.1 vers la version 25.2
Versions à venir
v26 Octobre 2026 Novembre 2027  
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 :

  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, vous devriez voir vos requêtes récentes représentées sur chaque graphique. Vous pouvez voir à quelles méthodes 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.v25.services.GoogleAdsService.Mutate.
  4. (Facultatif) Choisissez la période que vous souhaitez afficher pour vos demandes.

Différences entre l'abandon et l'arrêt

TermeObsolescenceCoucher du soleil
Définition Une 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 arrêt, mais les références de ces versions ne sont plus mises en évidence pour indiquer qu'elles ne sont plus les plus récentes.

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 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 de l'API pour les versions obsolètes continuent de fonctionner normalement.

Vous pouvez accéder à nos points de terminaison de l'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 de l'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 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'obsolescence. 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 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 la bibliothèque cliente compatibles

Le tableau indique les bibliothèques clientes compatibles avec les différentes 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, v25). Pour connaître la version de la bibliothèque cliente requise pour les versions mineures, consultez le journal des modifications associé.

Java

Journal des modifications

Bibliothèque cliente pour Java
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#

Journal des modifications

Bibliothèque cliente pour .NET
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

Journal des modifications

Bibliothèque cliente pour PHP
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

Journal des modifications

Bibliothèque cliente pour Python
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

Journal des modifications

Bibliothèque cliente pour Ruby
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

Journal des modifications

Bibliothèque cliente pour Perl
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

Abandons et modifications de fonctionnalités

Bien que cette page se concentre sur les cycles de vie au niveau des versions 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 de la campagne Demand Gen) sont suivis séparément.

Pour consulter les cycles de vie des fonctionnalités à venir et les changements de comportement dans les versions actives, consultez le guide Obsolescence des fonctionnalités et modifications sans version.