Guide de Transition : API Google Ad Manager
v202602 → v202605

Pourquoi cette migration est-elle obligatoire ?

L'API Google Ad Manager suit un cycle de publication trimestriel avec une politique de fin de vie très stricte. Chaque version de l'API (au format v20YYQQ) n'est supportée que pendant environ un an. Une fois ce délai passé, la version est désactivée et toutes les requêtes SOAP/REST vers celle-ci échouent immédiatement avec une erreur de version obsolète.

Le calendrier trimestriel est prévisible : v202602 (fév. 2026), v202605 (mai 2026), v202608 (août 2026), v202611 (nov. 2026). OrbiAds cible toujours la version la plus récente disponible au moment de la mise à jour, actuellement v202605.

Changements majeurs introduits en v202602

• Dépréciation des champs Smart Banners : Les champs liés aux anciens Smart Banners sur les objets Creative et LineItem ont été définitivement supprimés. Les intégrations doivent utiliser les bannières adaptatives et les formats fluides.
• Nouvelles dimensions GA4 dans ReportService : Des dimensions de visibilité et de mesures d'enchères GA4 ont été intégrées au ReportService SOAP.
• Vérifications OAuth2 renforcées : Des contrôles réseau plus stricts sont appliqués sur les requêtes mutatives (création, modification, suppression de ressources GAM).

Ce qui change entre v202602 et v202605

La v202605 apporte des évolutions importantes, notamment dans l'API REST Reporting. Voici les points critiques relevés lors de nos tests d'intégration :

• Endpoint DELETE supprimé de l'API REST Reporting : Il n'existe aucun endpoint DELETE /v1/networks/{nc}/reports/{id} fonctionnel. Malgré ce que documentent certains SDKs legacy, l'URL renvoie un HTTP 404. La suppression s'effectue désormais exclusivement via un PATCH sur le champ visibility: "HIDDEN" (soft-delete).
• Catalogue de métriques REST strict : 75 métriques héritées de l'ère SOAP (TOTAL_*, AD_SERVER_ALL_REVENUE…) sont rejetées par le moteur REST. Le catalogue v202605 définit 68 métriques valides et 79 dimensions valides.
• Noms des champs de plage de dates corrigés : Les payloads REST utilisent désormais "relative" (et non "relativeDateRange"), et "fixed" (et non "fixedDateRange"). Également, le champ de filtres s'appelle "filters" et non "dimensionFilters".
• Pas d'API destinataires sur les rapports : L'ajout de destinataires par email sur les rapports REST n'est pas exposé côté API — cette fonctionnalité reste cantonnée à l'interface GAM.

Pour la liste exhaustive des changements version par version, consultez les notes de version officielles de l'API Google Ad Manager .

Comment mettre à jour vos propres intégrations

Si vous maintenez des scripts internes via le SDK Python de Google, modifiez la version dans chaque appel de service :

# Avant (version février 2026)
from googleads import ad_manager
client = ad_manager.AdManagerClient.LoadFromStorage()
line_item_service = client.GetService('LineItemService', version='v202602')

# Après (version mai 2026 — cible actuelle)
from googleads import ad_manager
client = ad_manager.AdManagerClient.LoadFromStorage()
line_item_service = client.GetService('LineItemService', version='v202605')

Mettez également à jour le SDK pour récupérer les derniers schémas WSDL :

pip install --upgrade googleads