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 maintenir au maximum cinq versions majeures disponibles à tout moment.
- 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).
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 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'annonce de l'arrêt des versions de l'API.
* La version 26.1 est désignée comme version facultative en raison du 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 demandes 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, comme
google.ads.googleads.v25.services.GoogleAdsService.Mutate. - (Facultatif) Choisissez la période pour laquelle vous souhaitez afficher vos demandes.
Différences entre l'abandon et l'arrêt
| Terme | Obsolescence | Coucher du soleil |
|---|---|---|
| Définition | Une version obsolète est une version qui n'est pas la plus récente. 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, 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 profiter des nouvelles fonctionnalités. |
Pour utiliser l'API Google Ads, vous devez immédiatement migrer depuis les versions abandonnées.
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 fonctionnent toujours comme d'habitude.
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 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 de 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, la version 25). 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 |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
v22 |
Min: 41.0.0Max: - |
C#
API Google Ads |
Bibliothèque cliente pour .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
v22 |
Min: 24.1.0Max: - |
PHP
API Google Ads |
Bibliothèque cliente pour PHP |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
v22 |
Min: 31.0.0Max: - |
Python
API Google Ads |
Bibliothèque cliente pour Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
v22 |
Min: 28.1.0Max: 32.0.0
|
Ruby
API Google Ads |
Bibliothèque cliente pour Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
v22 |
Min: 36.0.0Max: - |
Perl
API Google Ads |
Bibliothèque cliente pour Perl |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
v22 |
Min: 29.0.0Max: - |
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 budgétaires pour les campagnes de génération de la demande) 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.