Avec le lancement d'une nouvelle version, une version obsolète se voit attribuer une date d'abandon. Passé ce délai, elle ne sera plus disponibles. 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 les mises à niveau dans un ordre séquentiel strict. Par exemple, vous pouvez de la version (N) directement à la version (N+2).
- Chevauchement entre la date de publication de toutes les bibliothèques clientes pour le la dernière version et celle qui doit être arrêtée au bout de 20 semaines minimum.
Nos bibliothèques clientes sont compatibles avec toutes les versions disponibles Vous pouvez donc procéder à la mise à niveau progressivement en spécifiant différentes versions services.
Horaires
Le tableau ci-dessous indique les dates d'abandon et d'arrêt pour chaque la version disponible et les dates de sortie prévues pour de futures versions. Mer nous vous invitons à passer à la dernière version dès que possible après son de sortie.
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 | 7 août 2024 | Sept./Oct. 2024 | Mai 2025 | |
v17 | 5 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 | Passer de la v16 à la v17 |
v15 | 18 octobre 2023 | 21 février 2024 | 25 septembre 2024 | Passer de la v15 à la v16 |
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 METRICS, vos requêtes récentes doivent être représentées par
chaque graphique. Vous pouvez voir les méthodes auxquelles vous avez envoyé des requêtes dans la
Methods (Méthodes). 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.v17.services.GoogleAdsService.Mutate
- (Facultatif) Sélectionnez la période à afficher pour vos requêtes.
Différences entre abandon et arrêt
Terme | Obsolescence | Coucher de soleil |
---|---|---|
Définition | La version obsolète est pas la plus récente. Lorsqu'une nouvelle version est publiée, toutes les versions précédentes sont identifiées Obsolète. | La version obsolète ne peut plus être utilisée. Demandes envoyées à ce échouera à compter de sa date d'arrêt. |
Conséquences | Vous pouvez continuer à utiliser les versions obsolètes jusqu'à leur abandon.
mais les références des versions obsolètes sont supprimées de la mise en surbrillance 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 et profiter de nouvelles fonctionnalités. |
Vous devez effectuer la mise à niveau immédiatement à partir des versions abandonnées dans
pour utiliser l'API Google Ads.
Nous vous recommandons vivement de passer à la dernière version version, à l'aide du guide de mise à niveau. |
Durée | En moyenne, nous publions une nouvelle version tous les trois à quatre mois. sera abandonnée au bout de 3 à 4 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. activé ; Toutefois, les 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 le les dates d'arrêt complet. L'API Google Ads génère une erreur si vous essayez d'accéder à la Points de terminaison d'API des versions arrêtées. |
Bibliothèques clientes | Afin de vous fournir des bibliothèques clientes compactes, nous allons arrêter Inclure des versions d'API obsolètes dans une nouvelle version de la bibliothèque cliente après la date d'abandon. Cela vous permet d'économiser de l'espace lors de l'intégration nos bibliothèques clientes dans vos projets. <ph type="x-smartling-placeholder"> | Les bibliothèques clientes ne sont plus compatibles avec les versions d'API abandonnées dans toute nouvelle version de la bibliothèque cliente après cette date. |
Assistance | Nous fournissons une assistance régulière pour les versions obsolètes. | Les versions abandonnées ne sont plus disponibles après le coucher du soleil. la date de début. |
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 |
v17 |
Min: 32.0.0 Max: – |
v16 |
Min: 30.0.0 Max: – |
v15 |
Min: 28.0.0 Max: 32.0.0 |
C#
API Google Ads |
Bibliothèque cliente pour .NET |
v17 |
Min: 20.1.0 Max: – |
v16 |
Min: 18.1.0 Max: – |
v15 |
Min: 17.1.0 Max: 20.1.0 |
PHP
API Google Ads |
Bibliothèque cliente pour PHP |
v17 |
Min: 23.1.0 Max: – |
v16 |
Min: 22.1.0 Max: – |
v15 |
Min: 21.1.0 Max: 23.1.0
|
Python
API Google Ads |
Bibliothèque cliente pour Python |
v17 |
Min: 24.1.0 Max: – |
v16 |
Min: 23.1.0 Max: – |
v15 |
Min: 22.1.0 Max: – |
Ruby
API Google Ads |
Bibliothèque cliente pour Ruby |
v17 |
Min: 29.0.0 Max: – |
v16 |
Min: 27.0.0 Max: – |
v15 |
Min: 25.0.0 Max: – |
Perl
API Google Ads |
Bibliothèque cliente pour Perl |
v17 |
Min: 23.0.0 Max: – |
v16 |
Min: 21.0.0 Max: – |
v15 |
Min: 19.0.0 Max: – |
Abandons de fonctionnalités
Consultez régulièrement le blog des développeurs Google Ads. pour être la première à être informée de l'abandon de certaines fonctionnalités.
Le tableau ci-dessous liste les fonctionnalités qui sont actuellement prévu pour l'API Google Ads. Vous trouverez plus d'informations sur chaque abandon dans les articles de blog associés.
Fonctionnalité | Description | Date d'entrée en vigueur | Remarques supplémentaires |
---|---|---|---|
Stratégie d'enchères "Commissions" |
L'API Google Ads
<ph type="x-smartling-placeholder"></ph>
ne permet plus de créer des campagnes d'hôtel avec COMMISSION
stratégie d'enchères
.
|
30 avril 2024 |
Demandes de création de campagnes d'hôtel ou d'application de l'COMMISSION
stratégie d'enchères à des campagnes existantes entraîne un
BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED
. Campagnes existantes utilisant la stratégie d'enchères "COMMISSION "
continue de s'appliquer jusqu'au 31 octobre 2024. Après ce jour
Les campagnes ne seront plus diffusées tant que leur stratégie d'enchères n'aura pas été mise à jour.
|