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 à prendre en compte:

  • Au maximum, trois versions majeures sont disponibles à la fois.
  • La durée de vie des versions majeures est d'environ 12 mois, et celle des versions mineures est 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 directement de la version (N) à la version (N+2).
  • La période de chevauchement entre la date de publication de toutes les bibliothèques clientes pour la dernière version et la version à abandonner 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 suivant répertorie les dates d'abandon et de fin de vie spécifiques 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.

Version de l'API Date de sortie Début de la période d'abandon Date d'abandon Guide de migration
v18 16 octobre 2024 Février 2025 24 septembre 2025
v17.1 7 août 2024 16 octobre 2024 4 juin 2025 Passer de la version 17 à la version 18
v17 5 juin 2024 16 octobre 2024 4 juin 2025 Passer de la version 17 à la version 18
v16.1 24 avril 2024 5 juin 2024 5 février 2025 Passer de la version 16 à la version 17
v16 21 février 2024 5 juin 2024 5 février 2025 Passer de la version 16 à la version 17

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 Google Cloud Console:

  1. Ouvrez API et services dans la console Google Cloud.
  2. Cliquez sur API Google Ads dans le tableau.
  3. Dans le sous-onglet MÉTRIQUES, vos requêtes récentes doivent s'afficher 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, par exemple google.ads.googleads.v18.services.GoogleAdsService.Mutate.
  4. (Facultatif) Choisissez la période à afficher pour vos demandes.

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

TermeObsolescenceCoucher de soleil
Définition La version obsolète est une version qui n'est pas la dernière. 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'abandon ou après celle-ci.
Implication Vous pouvez toujours utiliser les versions obsolètes jusqu'à leur abandon, mais les références des versions obsolètes ne sont plus mises en surbrillance pour indiquer qu'elles ne sont plus les dernières.

Nous vous encourageons à passer à la dernière version dès que possible pour profiter des nouvelles fonctionnalités.

 Vous devez immédiatement passer des versions abandonnées à 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 donnée sera donc abandonnée au bout d'environ trois à quatre mois. Nous prévoyons d'abandonner une version un an après sa publication.
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, 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 abandonnées cessent de fonctionner après les dates d'abandon. L'API Google Ads génère une erreur si vous tentez 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 les versions d'API obsolètes dans une nouvelle version de bibliothèque cliente après la date d'abandon. Cela vous permet de gagner de l'espace lorsque vous incorporez 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 proposons une assistance régulière pour les versions obsolètes. Les versions abandonnées ne sont plus compatibles après la date d'abandon.

Versions de bibliothèques clientes compatibles

Le tableau indique les bibliothèques clientes compatibles avec les versions d'API.

Java

Bibliothèque cliente pour Java
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: 34.0.0

C#

Bibliothèque cliente pour .NET
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: -

PHP

Bibliothèque cliente pour PHP
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -

Python

Bibliothèque cliente pour Python
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -

Ruby

Bibliothèque cliente pour Ruby
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -

Perl

Bibliothèque cliente pour Perl
v18 Min: 25.0.1
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -

Abandons de fonctionnalités

Consultez régulièrement le blog dédié aux développeurs Google Ads pour être le premier informé des futures fonctionnalités obsolètes.

Le tableau suivant répertorie les fonctionnalités spécifiques qui seront abandonnées dans l'API Google Ads. Pour en savoir plus sur chaque abandon, consultez les articles de blog associés.

Fonctionnalité Description Date d'entrée en vigueur Remarques supplémentaires
Mise à jour du rapport sur les insights sur les termes de recherche de l'API Google Ads et des scripts Google Ads à partir du 3 mars 2025 À partir du 3 mars 2025, les rapports sur les insights sur les termes de recherche de l'API Google Ads et des scripts Google Ads afficheront toutes les sous-catégories de recherche comme vides. L'interface utilisateur de Google Ads a déjà supprimé ce champ, et l'API déploie également cette modification pour assurer la cohérence dans Google Ads. 3 mars 2025 À partir du 3 mars 2025, toutes les valeurs de segments.search_subcategory devraient être vides. Si vous interrogez segments.search_subcategory dans les rapports campaign_search_term_insight ou customer_search_term_insight, vérifiez que votre code peut gérer une valeur vide dans segments.search_subcategory. Une chaîne vide est déjà un élément générique. Votre code devrait donc déjà gérer cela. Nous vous recommandons de supprimer segments.search_subcategory de votre requête.
Modifications à venir concernant la taille des pages dans l'API Google Ads Lorsque la version 16 sera abandonnée, vous ne pourrez plus définir le champ page_size lorsque vous enverrez des requêtes GoogleAdsService.Search. Février 2025 Lorsque la version 16 sera abandonnée, toutes les requêtes GoogleAdsService.Search supposeront une taille de page fixe de 10 000 lignes.
Mise à jour concernant l'expiration de l'appartenance au ciblage par liste de clients À partir du 7 avril 2025, le champ UserList.membership_life_span n'acceptera plus de valeurs supérieures à 540. 7 avril 2025 Du 7 avril 2025 au 15 avril 2025, nous allons déployer progressivement une modification du champ UserList.membership_life_span. Les requêtes visant à définir le champ sur une valeur supérieure à 540 renvoient une erreur RangeError.TOO_HIGH. Toute liste d'utilisateurs existante dont la valeur de champ est supérieure à 540 sera automatiquement migrée pour avoir une durée de validité de 540 jours maximum. Pour en savoir plus, consultez la section Mise à jour concernant l'expiration de l'accès au ciblage par liste de clients.