La Google Ads API v24 a été lancée le 22 avril 2026. Cette nouvelle version apporte des changements structurels importants sur les campagnes, la gestion des conversions, les rapports Shopping et les services de planification. Développeurs, agences et annonceurs programmatiques doivent anticiper plusieurs breaking changes avant de migrer.
Qu’est-ce que la Google Ads API v24 ?
La Google Ads API (anciennement AdWords API) est l’interface programmatique officielle de Google permettant de gérer des comptes publicitaires à grande échelle : création de campagnes, gestion des enchères, reporting avancé, optimisation automatisée. La version 24 succède à la v23.2 et introduit des changements majeurs dans 9 domaines clés.
Date de sortie : 22 avril 2026
Sunset prévu pour les versions antérieures : consulter la roadmap officielle Google
Documentation : Release Notes Google Ads API
1. Changements sur les annonces (Ads)
La v24 rend obligatoires plusieurs champs jusqu’ici optionnels dans les formats vidéo. Ces breaking changes nécessitent une mise à jour de votre code d’intégration.
DemandGenVideoResponsiveAdInfo — les champs videos et logo_images deviennent obligatoires.
VideoResponsiveAdInfo — les champs videos, business_name et logo_images deviennent obligatoires. De plus, l’objet VideoResponsiveAdInfo est désormais mutable, ce qui ouvre la possibilité de modifier ces annonces après création.
⚠️ Action requise : Vérifiez que vos appels API qui créent des annonces Demand Gen vidéo et des VideoResponsiveAds incluent bien ces champs. Sans mise à jour, les requêtes retourneront des erreurs de validation.
2. Nouveautés sur les assets
Un nouveau champ travel_feed_data est ajouté à la ressource AssetSet. Il permet de lire les données d’un travel feed asset set, exposant des informations en lecture seule :
hotel_center_account_idmerchant_center_idpartner_center_idsubset_idtravel_feed_vertical_type
Cette évolution simplifie la gestion des campagnes Travel et l’accès aux données de feed hôtelier depuis l’API.
3. Mises à jour des campagnes
Champ supprimé : video_brand_safety_suitability
Le champ Campaign.video_brand_safety_suitability est supprimé en v24. Le contrôle reste disponible au niveau Customer via Customer.video_brand_safety_suitability. Toute référence à ce champ au niveau campagne doit être supprimée de vos intégrations.
Nouveau champ : view_through_conversion_optimization_enabled
Le nouveau champ Campaign.view_through_conversion_optimization_enabled (valeur par défaut : false) permet d’activer l’optimisation VTC (View-Through Conversion) pour les campagnes Demand Gen et App Campaigns. Une avancée significative pour les annonceurs qui mesurent l’impact des impressions sur les conversions post-vue.
Exclusions de genre pour Performance Max
Les exclusions de genre sont désormais disponibles pour les campagnes Performance Max, et ce sur toutes les versions de l’API Google Ads. Un contrôle attendu depuis longtemps par les annonceurs gérant des produits ou services à audience genrée.
4. Nouvelles conversions : Lead Gen et Firebase
La v24 introduit le support des types de conversion Lead Gen, avec de nouveaux ConversionActionType enums couvrant tout le funnel de lead :
| Source | Étape funnel | Enum |
|---|---|---|
| Google Analytics 4 | Generate Lead | GOOGLE_ANALYTICS_4_GENERATE_LEAD |
| Google Analytics 4 | Qualify Lead | GOOGLE_ANALYTICS_4_QUALIFY_LEAD |
| Google Analytics 4 | Close/Convert Lead | GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD |
| Firebase Android | Generate Lead | FIREBASE_ANDROID_GENERATE_LEAD |
| Firebase Android | Qualify Lead | FIREBASE_ANDROID_QUALIFY_LEAD |
| Firebase Android | Close/Convert Lead | FIREBASE_ANDROID_CLOSE_CONVERT_LEAD |
| Firebase iOS | Generate Lead | FIREBASE_IOS_GENERATE_LEAD |
| Firebase iOS | Qualify Lead | FIREBASE_IOS_QUALIFY_LEAD |
| Firebase iOS | Close/Convert Lead | FIREBASE_IOS_CLOSE_CONVERT_LEAD |
Par ailleurs, le type de liste d’utilisateurs LOYALTY_SIGN_UPS est supprimé en v24.
5. Nouveautés dans les rapports
Nouvelle ressource : CartDataSalesView
La nouvelle ressource CartDataSalesView est l’une des ajouts les plus attendus de la v24. Elle permet de segmenter les métriques de conversion non seulement par le produit cliqué, mais aussi par le produit réellement vendu, avec des segments comme product_sold_brand. Une révolution pour l’analyse du panier d’achat.
Métriques non-biddable
De nouvelles métriques non-biddable sont ajoutées — elles incluent les conversions que vos campagnes n’optimisent pas activement. Exemple : all_cost_of_goods_sold_micros. Ces métriques sont disponibles pour toutes les ressources supportant les métriques biddable correspondantes.
Suppressions dans les rapports
- Suppression du segment
ad_sub_network_typepour la ressourcecampaign_budget - Suppression du segment
click_typedes vuesAdGroupAsset,CampaignAssetetCustomerAsset - Ajout du segment
conversion_attribution_event_typedansShoppingPerformanceView
6. Shopping : filtrage par tags et App Campaigns
La v24 introduit un système de filtrage de produits par tags avec expressions logiques pour les Shopping Campaigns (fonctionnalité réservée aux utilisateurs allowlistés) :
- Nouveaux types de critères :
RETAIL_FILTER_BUNDLEetRETAIL_FILTER - Nouveau
SharedSetType:RETAIL_FILTER AdGroupCriterionpeut utiliserretail_filter_bundlepour lier à unSharedSetSharedCriterionpeut utiliserretail_filterpour définir des règles de tags individuelles- Ajout de
RETAILdansListingGroupFilterListingSource - Ajout de la dimension
RetailFilterdansAssetGroupListingGroupFilter
Par ailleurs, les App Campaigns sont désormais supportées dans la ressource ShoppingProduct. Note : les champs status et issues ne sont pas supportés pour les App Campaigns.
7. Mises à jour Planning
Plusieurs changements structurels impactent le service de planification :
- Breaking change : Le type
InsightsAudience.topic_audience_combinationspasse deInsightsAudienceAttributeGroupàcommon.InsightsAudienceAttributeGroup— les bibliothèques client typées nécessitent une mise à jour. - Suppression du champ
youtube_select_lineupsdansReachPlanService.ListPlannableProducts→ migrer versyoutube_select_lineup_targeting. - Suppression du champ
is_brand_connect_creator→ utiliserpartnership_opportunitiesà la place. - Nouveaux champs dans la réponse
ListPlannableProductsResponse:plannable_product_description,marketing_objective,cost_model,buying_method.
Dans KeywordPlanIdeaService.GenerateKeywordForecastMetrics, plusieurs champs sont supprimés :
geo_modifiers[]→ remplacé pargeo_target_constants[]biddable_keywords[]→ remplacé parkeywords[]keyword_plan_network,negative_keywords,max_cpc_bid_micros- Métriques supprimées :
impressionsetclick_through_rate
8. Vidéos : ShareablePreviewService
Le service ShareablePreviewService.GenerateShareablePreviews est mis à jour pour ne plus utiliser le partial failure. Désormais, toute erreur sur un ID provoque une erreur globale de la requête. De nouveaux codes d’erreur alignés avec les ad group ad errors sont introduits :
MutateErrorEnum.RESOURCE_NOT_FOUND(remplaceShareablePreviewError.ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER)ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST(remplaceTOO_MANY_ASSET_GROUPS_IN_REQUEST)
Récapitulatif des breaking changes v24
| Domaine | Breaking Change | Action requise |
|---|---|---|
| Ads | Champs vidéo obligatoires (DemandGen & VideoResponsive) | Ajouter videos, logo_images, business_name |
| Campagnes | Suppression de Campaign.video_brand_safety_suitability | Migrer vers Customer.video_brand_safety_suitability |
| Conversions | Suppression de LOYALTY_SIGN_UPS | Mettre à jour les types de listes utilisateurs |
| Planning | Type topic_audience_combinations modifié | Mettre à jour les bibliothèques client typées |
| Planning | Suppression de youtube_select_lineups | Migrer vers youtube_select_lineup_targeting |
| Planning | Champs supprimés dans KeywordForecastMetrics | Adapter les requêtes de prévision |
| Rapports | Suppression de ad_sub_network_type (campaign_budget) | Supprimer ce segment des rapports |
| Rapports | Suppression de click_type (AdGroupAsset, CampaignAsset, CustomerAsset) | Adapter les requêtes GAQL concernées |
| Vidéos | ShareablePreview sans partial failure | Gérer les erreurs globalement |
Comment migrer vers Google Ads API v24 ?
La migration vers une nouvelle version majeure de l’API Google Ads suit toujours les mêmes étapes clés :
- Auditez vos intégrations actuelles — identifiez tous les champs supprimés ou modifiés listés ci-dessus dans votre code
- Mettez à jour votre client library — Google propose des bibliothèques officielles pour Python, Java, PHP, Ruby, .NET et Go
- Testez en environnement sandbox — utilisez un compte test Google Ads avant toute mise en production
- Planifiez le sunset — ne restez pas sur une version dépréciée, Google fixe des délais de sunset stricts
- Consultez la documentation officielle — Guide de migration Google Ads API
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).
Quels sont les principaux breaking changes de la v24 ?
Les breaking changes majeurs de la v24 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, et la suppression de plusieurs champs dans KeywordPlanIdeaService.
Les exclusions de genre sont-elles disponibles pour Performance Max en v24 ?
Oui. La v24 active les exclusions de genre pour les campagnes Performance Max sur toutes les versions de l’API Google Ads. Cette fonctionnalité était attendue par de nombreux annonceurs pour affiner le ciblage sur ce type de campagne automatisée.
Qu’est-ce que la nouvelle ressource CartDataSalesView ?
La CartDataSalesView est une nouvelle ressource de reporting introduite en v24. Elle permet d’analyser les conversions en segmentant à la fois par le produit cliqué et par le produit vendu (via product_sold_brand), offrant une vision précise de la performance par produit vendu réellement — et non seulement par produit mis en avant dans l’annonce.
L’API Google Ads est-elle accessible aux petites agences ?
L’API Google Ads nécessite un compte développeur approuvé par Google et est généralement utilisée par des agences gérant des volumes importants de comptes publicitaires. Pour la gestion opérationnelle de campagnes Google Ads à Liège et en Belgique, des outils d’interface comme Google Ads Editor ou les plateformes d’automatisation tierces sont souvent suffisants pour les PME.
Article rédigé par l’équipe AdSim, agence de marketing digital à Liège. Données issues des release notes officielles Google Ads API — dernière mise à jour : 28 avril 2026.
