Lorsque nous publions une nouvelle version, nous attribuons une date d'arrêt à une version obsolète, après laquelle elle ne sera plus disponible. Voici d'autres consignes à garder à l'esprit:
- Au maximum, trois versions majeures sont disponibles en même temps.
- Les versions majeures ont une durée de vie d'environ 12 mois. Les versions mineures : 10 mois.
- Vous devez effectuer au maximum deux mises à niveau par an et vous n'avez pas à effectuer les mises à niveau dans un ordre séquentiel strict (par exemple, vous pouvez passer directement de la version (N) à 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 effectuer une mise à niveau progressive en spécifiant différentes versions des services utilisés.
Horaires
Le tableau ci-dessous répertorie 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 son lancement.
| Version de l'API | Date de sortie | Début de la période d'abandon | Date d'abandon | Guide de mise à niveau |
|---|---|---|---|---|
| v18 | Septembre/Octobre 2024 | Jan./févr. 2025 | Septembre 2025 | |
| v17.1 | Juil./août 2024 | Septembre/Octobre 2024 | Mai 2025 | |
| v17 | Mai/Juin 2024 | Septembre/Octobre 2024 | Mai 2025 | |
| v16.1 | Avril/mai 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 une liste des méthodes et des 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, 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 la table Methods (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.v16.services.GoogleAdsService.Mutate. - (Facultatif) Sélectionnez la période à afficher pour vos demandes.
Différences entre abandon et arrêt
| Terme | Obsolescence | Arrêté |
|---|---|---|
| Définition | La version obsolète est une version qui n'est pas la dernière. Lorsqu'une nouvelle version est publiée, toutes les versions précédentes sont marquées comme obsolètes. | La version d'arrêt ne peut plus être utilisée. Les requêtes envoyées à cette version échoueront à la date d'arrêt ou après celle-ci. |
| Implication | Vous pouvez toujours utiliser les versions obsolètes jusqu'à leur arrêt progressif, mais leurs références sont désélectionnées pour indiquer qu'il ne s'agit plus de la dernière version.
Nous vous encourageons à passer à la dernière version dès que possible pour bénéficier des nouvelles fonctionnalités. |
Pour pouvoir utiliser l'API Google Ads, vous devez immédiatement effectuer la mise à niveau depuis ces versions.
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 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 l'API à l'aide de nos bibliothèques clientes, de REST, etc. Toutefois, les nouvelles fonctionnalités ne sont pas ajoutées aux versions obsolètes. |
Les points de terminaison de l'API pour les versions d'arrêt ne fonctionnent plus après ces dates. L'API Google Ads génère une erreur si vous essayez d'accéder aux points de terminaison de l'API des versions abandonnées. |
| Bibliothèques clientes | Afin de fournir des bibliothèques clientes compactes, nous cesserons d'inclure des versions d'API obsolètes dans une nouvelle version des bibliothèques clientes après la date d'abandon. Cela vous permet d'économiser de l'espace lorsque vous intégrez nos bibliothèques clientes à vos projets. | Les bibliothèques clientes ne prennent plus en charge les versions d'arrêt de l'API dans les nouvelles versions des bibliothèques clientes après la date d'arrêt du produit. |
| Assistance | Nous fournissons une assistance régulière pour les versions obsolètes. | Les versions d'arrêt ne sont plus acceptées après la date d'arrêt. |
Versions des bibliothèques clientes compatibles
Le tableau indique les bibliothèques clientes compatibles avec les versions de l'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: - |
C#
API Google Ads |
Bibliothèque cliente pour .NET |
v16 |
Min: 18.1.0Max: - |
v15 |
Min: 17.1.0Max: - |
v14 |
Min: 16.1.0Max: - |
PHP
API Google Ads |
Bibliothèque cliente pour PHP |
v16 |
Min: 22.1.0Max: - |
v15 |
Min: 21.1.0Max: - |
v14 |
Min: 19.2.0Max: - |
Python
API Google Ads |
Bibliothèque cliente pour Python |
v15 |
Min: 22.1.0Max: - |
v14 |
Min: 21.2.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: - |
Perl
API Google Ads |
Bibliothèque cliente pour Perl |
v16 |
Min: 21.0.0Max: - |
v15 |
Min: 19.0.0Max: - |
v14 |
Min: 17.0.0Max: - |
Abandons de fonctionnalités
Consultez régulièrement le blog des développeurs Google Ads pour être le premier à être informé des abandons à venir de fonctionnalités.
Le tableau ci-dessous liste 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 associés.
| 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.
|