La version 24 de l'API Google Ads est désormais disponible

Google a publié la version 24 de l'API Google Ads, il s'agit d'une version majeure avec des dizaines de mises à jour. Cette mise à jour inclut des modifications apportées à Demand Gen, aux flux de voyage, aux types de conversion, aux achats, aux rapports, aux vidéos et bien plus encore.

Google a écrit : « Aujourd'hui, nous annonçons la version v24 de l'API Google Ads. »

Avant cette version c'était la version 23.2 en mars, puis la v23.1 en février puis la 23 fin janvier, puis la version 22 le 15 octobre 2025, puis la version 21 le 6 août 2025, puis la 20 le 5 juin 2025, la 19.1 en avril 2025, puis la 19 en février 2025, puis la version 18 en octobre 2024. Avant cela, c'était la version 17.1 en août 2024, puis avant cela, c'était la version 17.0 en juin 2024, puis avant cela, c'était la version 16.1, puis la version 16 en février 2024. Avant cela, c'était la version 15 en octobre 2023. Puis avant cela, c'était la version 14.1 qui a été publiée en août. La version 13.1 a précédé cette nouvelle version, sortie en avril 2023. La version 12.0 a été publiée en octobre 2022, la version 11.0 de l'API Google Ads a été publiée en juin et la version 11.1 en août. La version 10.1 a également été publiée le 27 avril 2022 et la version 10.0 le 9 février 2022. Et Google a mis fin à l'API AdWords le 27 avril, qui cessera complètement de fonctionner fin juillet.

Voici les notes de version :

Annonces : les champs suivants sont désormais obligatoires :

Dans l'objet DemandGenVideoResponsiveAdInfo : vidéos, logo_images

Dans l'objet VideoResponsiveAdInfo : videos, business_name, logo_images

Le VideoResponsiveAdInfo est désormais mutable.

Actifs:

Ajout du champ travel_feed_data à la ressource AssetSet. Ce nouveau champ permet de lire les données de flux de voyage à partir d'un ensemble d'actifs de flux de voyage, exposant des informations en lecture seule telles que hotel_center_account_id, Merchant_center_id, Partner_center_id, subset_id et travel_feed_vertical_type.

Campagnes :

Suppression du champ Campaign.video_brand_safety_suitability. Le contrôle est toujours disponible au niveau Client. Voir Customer.video_brand_safety_suitability.

Ajout du champ Campaign.view_through_conversion_optimization_enabled, qui est faux par défaut, pour permettre l'activation de l'optimisation VTC (View-Through Conversion) dans les campagnes de génération de demande et d'application.

Activation des exclusions de genre pour les campagnes Performance Max. Cette exclusion est désormais disponible pour les campagnes Performance Max sur toutes les versions de l'API Google Ads.

Conversions :

Ajout de la prise en charge des types de conversion Lead Gen. Il s'agit du nouveau ConversionActionType. énumérations dans la v24 :

Suppression de la catégorie de type de client de la liste d'utilisateurs LOYALTY_SIGN_UPS.

Général:

Ajout de UserListErrorEnum.DUPLICATE_LOOKALIKE, qui est renvoyé lors de la tentative de création d'une UserList similaire et identique à une liste existante.

Planification:

Modification de la définition du type InsightsAudience.topic_audience_combinations de InsightsAudienceAttributeGroup à common.InsightsAudienceAttributeGroup. Pour les bibliothèques clientes typées, il s’agit d’un changement radical qui nécessite des mises à jour des intégrations existantes. Suppression du champ youtube_select_lineups du service ReachPlanService.ListPlannableProducts.

Les utilisateurs doivent utiliser les lineups de youtube_select_lineup_targeting.

Suppression du champ is_brand_connect_creator des services ContentCreatorInsightsService.GenerateCreatorInsights et ContentCreatorInsightsService.GenerateTrendingInsights.

Les utilisateurs doivent plutôt rechercher un créateur pour que l'option CREATOR_PARTNERSHIPS soit disponible dans Partnership_opportunities.

Ajout de nouveaux champs à la réponse ReachPlanService.ListPlannableProducts pour inclure plus de détails sur chaque produit planifiable. La plupart de ces champs sont renvoyés dans le nouveau champ ProductCoreAttributes dans ListPlannableProductsResponse. De nouveaux champs de réponse sont…

Suppression de divers champs de KeywordPlanIdeaService.GenerateKeywordForecastMetrics :

Rapports :

Suppression du segment ad_sub_network_type pour la ressource Campaign_budget.

Suppression du segment click_type des vues AdGroupAsset, CampaignAsset et CustomerAsset.

Ajout d'une nouvelle ressource CartDataSalesView. Il permet de segmenter les mesures de conversion non seulement par produit cliqué, mais également par produit vendu, avec des segments comme product_sold_brand.

Ajout de métriques sans enchère, qui incluent également les conversions vers lesquelles vos campagnes n'optimisent pas activement, par exemple all_cost_of_goods_sold_micros. Les nouvelles métriques sont ajoutées à toutes les ressources prenant en charge les métriques enchérissantes correspondantes.

Ajout du segment conversion_attribution_event_type à la ressource ShoppingPerformanceView.

Achats:

Ajout de la prise en charge des campagnes pour applications dans la ressource ShoppingProduct. Notez que les champs d'état et de problèmes ne sont pas compatibles avec les campagnes pour applications.

Introduction du filtrage de produits basé sur des balises à l'aide d'expressions logiques pour les campagnes Shopping.

Vidéos :

Mise à jour de ShareablePreviewService.GenerateShareablePreviews pour ne plus utiliser d'échec partiel. Les requêtes généreront une erreur si elles échouent pour un ID. Renvoi de nouveaux codes d'erreur pour les groupes d'éléments afin de les aligner sur les erreurs d'annonces des groupes d'annonces :

Discussion sur le forum X.