Google Ads, SEA

Google Ads API v24 : toutes les nouveautés et changements à connaître (2026)

avril 30, 2026
Aucun commentaire

La Google Ads API v24, lancée le 22 avril 2026, introduit des breaking changes critiques sur les annonces vidéo DemandGen, supprime Campaign.video_brand_safety_suitability et ouvre les exclusions de genre aux campagnes Performance Max. Les bibliothèques client officielles (Python, Java, PHP, Ruby, .NET, Go) sont disponibles sur GitHub. Migration recommandée avant le sunset prévu des versions antérieures.

On va être honnêtes : à chaque nouvelle version de la Google Ads API, on passe quelques heures à éplucher les release notes, tester les breaking changes sur nos environnements sandbox, et adapter nos scripts d’automatisation. La v24 ne fait pas exception — et elle réserve quelques surprises, notamment sur les campagnes DemandGen vidéo et Planning.

Ce guide compile ce qu’on a constaté en production, avec des exemples de code concrets pour chaque changement majeur.

Qu’est-ce que la Google Ads API v24 ?

La Google Ads API (anciennement AdWords API) est l’interface programmatique officielle de Google pour gérer des comptes publicitaires à grande échelle : création de campagnes, gestion des enchères, reporting avancé, optimisation automatisée. Elle remplace définitivement l’AdWords API depuis 2019 et sort une à deux nouvelles versions majeures par an.

La version 24 succède à la v23.2 et introduit des changements dans 9 domaines clés. Date de sortie officielle : 22 avril 2026. Le sunset des versions antérieures suit la roadmap publiée sur le blog officiel Google Ads Developers.

💡 À retenir : Google respecte généralement un délai de 12 mois entre le lancement d’une version et le sunset de la précédente. Inutile de paniquer — mais mieux vaut planifier la migration maintenant que dans l’urgence.

1. Breaking changes sur les annonces vidéo — ce qui casse en production

C’est le changement qui a causé le plus d’erreurs dans nos intégrations lors des tests. Deux types d’annonces sont concernés.

DemandGenVideoResponsiveAdInfo

Les champs videos et logo_images deviennent obligatoires. Si votre code crée des annonces DemandGen sans ces champs, vous obtiendrez une erreur de validation dès la migration vers la v24.

# ❌ Code qui plante en v24
ad = Ad()
ad.demand_gen_video_responsive_ad = DemandGenVideoResponsiveAdInfo(
    headlines=[...],
    descriptions=[...],
    # videos et logo_images absents → ERREUR en v24
)

# ✅ Code corrigé pour v24
ad.demand_gen_video_responsive_ad = DemandGenVideoResponsiveAdInfo(
    headlines=[...],
    descriptions=[...],
    videos=[AdMediaBundleAsset(asset=video_asset_resource_name)],
    logo_images=[AdImageAsset(asset=logo_asset_resource_name)]
)

VideoResponsiveAdInfo — maintenant mutable

Même chose : videos, business_name et logo_images deviennent obligatoires. La bonne nouvelle — et c’est une vraie amélioration — c’est que VideoResponsiveAdInfo est désormais mutable. Vous pouvez enfin modifier ces annonces après création sans avoir à les supprimer et recréer.

⚠️ Action requise : Auditez tous vos appels de création d’annonces vidéo. Un simple grep sur DemandGenVideoResponsiveAdInfo et VideoResponsiveAdInfo dans votre codebase suffit pour identifier les zones à corriger.

2. Campagnes : suppression de video_brand_safety_suitability

Le champ Campaign.video_brand_safety_suitability est supprimé en v24. C’est un breaking change silencieux : votre code ne plantera pas forcément, mais le champ sera tout simplement ignoré — ce qui peut créer des comportements inattendus sur le brand safety de vos campagnes vidéo.

Solution : Le contrôle brand safety reste disponible, mais uniquement au niveau Customer (plus au niveau campagne). Mettez à jour vos scripts qui lisent ou écrivent ce champ en conséquence.

Nouveau champ ajouté : view_through_conversion_optimization_enabled (défaut : false). Il active l’optimisation VTC pour les campagnes Demand Gen et App Campaigns — une option que nous testons actuellement sur plusieurs comptes e-commerce belges.

3. Exclusions de genre pour Performance Max — enfin disponibles

C’est une demande que beaucoup d’annonceurs attendaient depuis des mois. Les exclusions de genre sont désormais disponibles pour les campagnes Performance Max via l’API. Jusqu’à présent, ces exclusions n’étaient accessibles que manuellement dans l’interface Google Ads — impossible à gérer programmatiquement à grande échelle.

Pour une utilisation avancée des capacités API sur PMax, consultez notre guide Google Ads API et Performance Max : automatisation, exclusions et contrôle avancé.

4. Nouvelles conversions : Lead Gen et Firebase

La v24 introduit des nouveaux ConversionActionType enums couvrant le funnel Lead Gen complet, avec support natif GA4 et Firebase (Android et iOS). C’est particulièrement utile pour les campagnes orientées génération de leads B2B.

Suppression à noter : le type de liste d’utilisateurs LOYALTY_SIGN_UPS disparaît en v24. Si vous utilisez ce type dans vos audiences, migrez vers les alternatives disponibles avant le sunset.

Pour tout ce qui concerne l’import de conversions offline, notre guide dédié couvre les cas d’usage les plus fréquents : Conversions offline avec la Google Ads API : guide complet.

5. CartDataSalesView : le vrai upgrade pour le reporting Shopping

Si vous gérez des campagnes Shopping PMax pour des e-commerçants, c’est probablement la nouveauté la plus intéressante de la v24. La ressource CartDataSalesView permet de segmenter les métriques de conversion par le produit réellement vendu, et non plus seulement par le produit qui a généré le clic.

En pratique, cela signifie qu’on peut enfin voir dans les rapports API quels produits ont été achetés après une conversion Shopping PMax — une granularité qui n’existait pas avant et qui change vraiment la donne pour l’attribution produit.

Suppressions dans les rapports :

ad_sub_network_type pour campaign_budget
click_type pour les vues AdGroupAsset, CampaignAsset, CustomerAsset

6. Shopping : filtrage par tags avec expressions logiques

La v24 introduit un système de filtrage de produits par tags avec expressions logiques pour les Shopping Campaigns. Deux nouveaux types font leur apparition : RETAIL_FILTER_BUNDLE et RETAIL_FILTER. Les App Campaigns sont désormais supportées dans ShoppingProduct.

7. Assets : nouveau champ travel_feed_data

Un nouveau champ travel_feed_data est ajouté à la ressource AssetSet. Il expose en lecture seule les données d’un travel feed asset set : hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type. Utile surtout pour les annonceurs du secteur hôtelier et voyage.

8. Planning : breaking change sur InsightsAudience

Changement structurel à ne pas louper : le type InsightsAudience.topic_audience_combinations passe de InsightsAudienceAttributeGroup à common.InsightsAudienceAttributeGroup. Si vous utilisez ce service pour la planification d’audiences, votre code doit être mis à jour.

Autre suppression : youtube_select_lineups — migrez vers youtube_select_lineup_targeting. Dans KeywordPlanIdeaService, plusieurs champs sont supprimés : geo_modifiers[], biddable_keywords[], keyword_plan_network.

9. ShareablePreviewService : plus de partial failure

Le service ShareablePreviewService.GenerateShareablePreviews ne supporte plus le partial failure. Concrètement : toute erreur sur un ID provoque désormais une erreur globale sur toute la requête. Si votre code s’appuyait sur le partial failure pour ignorer silencieusement les IDs invalides, il faut revoir la gestion des erreurs.

Comment migrer vers Google Ads API v24 — notre process en 5 étapes

Voici le process qu’on applique en interne chez AdSim, et qu’on recommande à nos clients qui gèrent leurs propres intégrations :

Auditez votre codebase — grep sur tous les champs supprimés ou modifiés listés ci-dessus. Commencez par video_brand_safety_suitability, LOYALTY_SIGN_UPS, youtube_select_lineups.
Mettez à jour votre client library — bibliothèques officielles disponibles sur GitHub googleads pour Python, Java, PHP, Ruby, .NET et Go.
Testez en sandbox — utilisez un compte test Google Ads avec les credentials de test. Ne testez jamais un breaking change en production.
Déployez progressivement — commencez par un seul compte avant de déployer sur l’ensemble de vos intégrations.
Planifiez le sunset — notez la date limite dans votre roadmap technique et prévoyez une revue 60 jours avant.

Pour un guide complet sur la gestion des versions et des sunset dates, consultez notre article : Google Ads API : guide de migration entre versions et gestion des sunset dates.

Pour aller plus loin dans la Google Ads API

Vous débutez avec l’API ou souhaitez approfondir vos connaissances ? Voici les guides essentiels de notre cocon sémantique :

FAQ — Google Ads API v24

Quand la Google Ads API v24 a-t-elle été lancée ?

La Google Ads API v24 a été lancée officiellement le 22 avril 2026. Elle est disponible pour toutes les bibliothèques client officielles — Python, Java, PHP, Ruby, .NET, Go — téléchargeables sur GitHub via l’organisation googleads.

Quels sont les principaux breaking changes de la v24 ?

Les breaking changes majeurs sont : les champs vidéo obligatoires pour DemandGen et VideoResponsiveAd, la suppression de Campaign.video_brand_safety_suitability, la modification du type topic_audience_combinations dans Planning, la suppression de youtube_select_lineups et la fin du partial failure dans ShareablePreviewService.

Faut-il migrer immédiatement vers la v24 ?

Non — mais anticipez. Google respecte généralement un délai de 12 mois entre le lancement d’une version et le sunset de la précédente. Avec une sortie en avril 2026, vous avez du temps, mais une migration préventive vous évitera une urgence technique en fin d’année. Consultez la roadmap officielle des sunset dates.

La v24 change-t-elle quelque chose pour les campagnes Performance Max ?

Oui — deux apports concrets : les exclusions de genre pour PMax sont désormais disponibles via API (impossible avant), et la ressource CartDataSalesView améliore significativement le reporting pour les campagnes Shopping PMax en exposant les produits réellement achetés. Voir notre guide complet Google Ads API et Performance Max.

Scripts ou API : laquelle choisir pour automatiser Google Ads ?

Pour des automatisations légères ou ponctuelles, Google Ads Scripts suffisent et ne requièrent aucune infrastructure. Pour des intégrations complexes, du multi-comptes, ou un contrôle programmatique complet (enchères, audiences, conversions), l’API s’impose. Notre comparatif complet Google Ads Scripts vs Google Ads API détaille les cas d’usage de chaque solution.

Où trouver les bibliothèques client pour la v24 ?

Toutes les bibliothèques officielles sont disponibles sur GitHub (organisation googleads) : google-ads-python, google-ads-java, google-ads-php, google-ads-ruby, google-ads-dotnet et google-ads-googleads-go. Vérifiez que la version de votre bibliothèque supporte bien la v24 avant de migrer.

undefined