Lorsque nous publions une nouvelle version, nous attribuons à une version obsolète une date d'abandon après laquelle elle ne sera plus disponible. Voici quelques autres consignes à garder à l'esprit:
- Au maximum, trois versions principales sont disponibles simultanément.
- Les versions majeures ont une durée de vie d'environ 12 mois. Les versions mineures : 10 mois.
- Vous devrez effectuer au maximum deux mises à niveau par an et vous n'avez pas à effectuer de mise à niveau dans un ordre séquentiel strict. Par exemple, vous pouvez passer de la version (N) directement à la version (N+2).
- Le chevauchement entre la date de publication de toutes les bibliothèques clientes pour la dernière version et la date d'arrêt de la version est d'au moins 20 semaines.
Nos bibliothèques clientes sont compatibles avec toutes les versions disponibles d'un service. Vous pouvez donc les mettre à niveau progressivement en spécifiant différentes versions des services utilisés.
Horaires
Le tableau ci-dessous liste les dates d'abandon et d'abandon spécifiques à 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 sa publication.
| Version de l'API | Date de sortie | Début de la période d'abandon | Date d'abandon | Guide de migration |
|---|---|---|---|---|
| v18 | Sept./Oct. 2024 | jan./févr. 2025 | Septembre 2025 | |
| v17.1 | Juil./Août 2024 | Sept./Oct. 2024 | Mai 2025 | |
| v17 | Mai/Juin 2024 | Sept./Oct. 2024 | Mai 2025 | |
| v16.1 | 24 avril 2024 | Mai/Juin 2024 | Janvier 2025 | |
| v16 | 21 février 2024 | Mai/Juin 2024 | Janvier 2025 | |
| v15 | 18 octobre 2023 | 21 février 2024 | 25 septembre 2024 | Passer de la v15 à la v16 |
| v14.1 | 9 août 2023 | 18 octobre 2023 | 5 juin 2024 | |
| v14 | 7 juin 2023 | 18 octobre 2023 | 5 juin 2024 | Passer de la v14 à la v15 |
Afficher les versions utilisées par votre projet
Vous pouvez afficher la liste des méthodes et services récemment appelés par votre projet à 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 doivent être représentées sur chaque graphique. Vous pouvez voir à quelles méthodes vous avez envoyé des requêtes dans la table Méthodes. Le nom de la méthode inclut une version de l'API Google Ads, un service et un nom de méthode, tel que
google.ads.googleads.v17.services.GoogleAdsService.Mutate. - (Facultatif) Sélectionnez la période à afficher pour vos requêtes.
Différences entre abandon et arrêt
| Terme | Obsolescence | Arrêté |
|---|---|---|
| Définition | La version obsolète est pas la plus récente. Lorsqu'une nouvelle version sera publiée, toutes les versions précédentes seront marquées comme obsolètes. | La version obsolète ne peut plus être utilisée. Les requêtes envoyées à cette version échoueront à la date d'arrêt ou après. |
| Conséquences | Vous pouvez continuer à utiliser les versions obsolètes jusqu'à leur arrêt, mais les références à celles-ci sont supprimées de la mise en surbrillance pour indiquer qu'il ne s'agit plus de la version la plus récente.
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 à ces versions pour pouvoir utiliser l'API Google Ads.
Nous vous recommandons vivement de passer à la dernière version à l'aide du 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 au bout de trois à quatre mois environ. | Nous prévoyons d'arrêter 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 aux points de terminaison de nos API à l'aide de nos bibliothèques clientes, de REST, etc. Toutefois, de nouvelles fonctionnalités ne sont pas ajoutées aux versions obsolètes. |
Les points de terminaison de l'API pour les versions arrêtées cessent de fonctionner après la date d'arrêt. L'API Google Ads génère une erreur si vous essayez d'accéder aux points de terminaison de l'API dans les versions arrêtées. |
| Bibliothèques clientes | Afin de fournir des bibliothèques clientes compactes, nous cesserons d'inclure les versions obsolètes de l'API dans une nouvelle version de la bibliothèque cliente après la date d'abandon. Cela vous permet de gagner de l'espace lorsque vous intégrez nos bibliothèques clientes à vos projets. | Après la date d'arrêt, les bibliothèques clientes ne sont plus compatibles avec les versions d'API abandonnées dans les nouvelles versions de bibliothèques clientes. |
| Assistance | Nous fournissons une assistance régulière pour les versions obsolètes. | Les versions abandonnées ne sont plus acceptées après la date d'arrêt. |
Versions compatibles des bibliothèques clientes
Le tableau indique quelles bibliothèques clientes fonctionnent avec quelles versions d'API.
Java
API Google Ads |
Bibliothèque cliente pour Java |
v16 |
Min: 30.0.0Max: - |
v15 |
Min: 28.0.0Max: - |
v14 |
Min: 26.0.0Max: 30.0.0
|
C#
API Google Ads |
Bibliothèque cliente pour .NET |
v16 |
Min: 18.1.0Max: - |
v15 |
Min: 17.1.0Max: - |
v14 |
Min: 16.1.0Max: 19.0.1 |
PHP
API Google Ads |
Bibliothèque cliente pour PHP |
v16 |
Min: 22.1.0Max: - |
v15 |
Min: 21.1.0Max: - |
Python
API Google Ads |
Bibliothèque cliente pour Python |
v16 |
Min: 23.1.0Max: - |
v15 |
Min: 22.1.0Max: - |
Ruby
API Google Ads |
Bibliothèque cliente pour Ruby |
v16 |
Min: 27.0.0Max: - |
v15 |
Min: 25.0.0Max: - |
v14 |
Min: 23.0.0Max: 27.0.0
|
Perl
API Google Ads |
Bibliothèque cliente pour Perl |
v16 |
Min: 21.0.0Max: - |
v15 |
Min: 19.0.0Max: - |
v14 |
Min: 17.0.0Max: 21.0.0 |
Abandons de fonctionnalités
Consultez régulièrement le blog des développeurs Google Ads pour être le premier informé des abandons de fonctionnalités à venir.
Le tableau ci-dessous répertorie les abandons de fonctionnalités spécifiques qui sont actuellement prévus pour l'API Google Ads. Pour en savoir plus sur chaque abandon, consultez les articles de blog en lien.
| Sélection | Description | Date d'entrée en vigueur | Remarques supplémentaires |
|---|---|---|---|
| Stratégie d'enchères "Commissions" |
L'API Google Ads
ne permet plus de créer des campagnes d'hôtel avec la stratégie d'enchères COMMISSION
.
|
30 avril 2024 |
Les demandes de création de campagnes d'hôtel ou d'application de la stratégie d'enchères COMMISSION à des campagnes existantes généreront une erreur BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Les campagnes existantes qui utilisent la stratégie d'enchères COMMISSION continueront d'être diffusées jusqu'au 31 octobre 2024. Passé ce délai, les campagnes ne seront plus diffusées tant que leur stratégie d'enchères n'aura pas été mise à jour.
|