Abandon et arrêt

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:

  1. Ouvrez la page API et services dans la console Google Cloud.
  2. Cliquez sur API Google Ads dans le tableau.
  3. 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
  4. (Facultatif) Sélectionnez la période à afficher pour vos requêtes.

Différences entre abandon et arrêt

TermeObsolescenceCoucher 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

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#

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

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

Bibliothèque cliente pour Python
v17 Min: 24.1.0
Max:
v16 Min: 23.1.0
Max:
v15 Min: 22.1.0
Max:

Ruby

Bibliothèque cliente pour Ruby
v17 Min: 29.0.0
Max:
v16 Min: 27.0.0
Max:
v15 Min: 25.0.0
Max:

Perl

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.