Google Ads Api

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

Google a publié la version 23 de l'API Google Ads, il s'agit d'une version majeure avec des dizaines de mises à jour. Les mises à jour incluent des données de rapport Performance Max avec répartition par type de réseau publicitaire, davantage d'incitations, de rapports et de contrôles de conversion, et bien plus encore.

Google a écrit : « Aujourd'hui, nous annonçons la version v23 de l'API Google Ads. Cela marque la première version de 2026 et le début de notre transition vers une cadence de publication plus rapide. »

Avant cette version, il y avait la version 22 le 15 octobre 2025, puis la version 21 le 6 août 2025, puis la version 20 le 5 juin 2025, la version 19.1 en avril 2025, puis la version 19 en février 2025, puis la version 18 en octobre 2024. Avant cela, c'était la version 17.1 en août 2024 et avant cela, la version 17.0 dans Juin 2024, puis avant cela, il y avait la version 16.1, puis la version 16 en février 2024. Avant cela, il y avait la version 15 en octobre 2023. Puis avant cela, il y avait 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 :

  • Ajout de AD_SHARING_NOT_ALLOWED à AdGroupAdErrorEnum. Cette erreur est renvoyée lors de la tentative de partage d'une annonce entre plusieurs groupes d'annonces, ce qui n'est plus autorisé.

  • Ajout de nouveaux types de format à AdFormatType : TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.

  • Suppression de la prise en charge de CallAd et CallAdInfo dans la v23. Consultez https://support.google.com/google-ads/answer/6341403 pour en savoir plus.

Actifs:

  • Ajout de métriques supplémentaires au rapport Asset_group : metrics.engagements, metrics.engagement_rate, metrics.average_cpe

  • Ajout de métriques supplémentaires au rapport Asset_group_asset : metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views, metrics.interaction_event_types

  • Ajout d'une orientation de champ en lecture seule pour les ressources image et vidéo dans Asset.

  • Ajout de la prise en charge pour récupérer CampaignAsset avec field_type HEADLINE et DESCRIPTION.

  • Ajout de HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE et DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO à ServedAssetFieldType pour les actifs servis comme liens annexes.

  • Actifs de messages professionnels mis à jour

Facturation:

  • InvoiceService.ListInvoices peut désormais renvoyer des détails plus précis dans Invoice, notamment la répartition des coûts au niveau de la campagne, les coûts réglementaires détaillés et les informations d'ajustement, en définissant include_granular_level_invoice_details dans ListInvoicesRequest.

  • Ajout de RegulatoryFeeTypeEnum et UnitOfMeasureEnum.

Campagnes :

  • Ajout des codes d'erreur CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET et CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.

  • Ajout de Campaign.start_date_time et Campaign.end_date_time pour remplacer Campaign.start_date et Campaign.end_date, permettant de spécifier des composants temporels pour certains types de campagnes.

Conversions :

  • Ajout de YOUTUBE_FOLLOW_ON_VIEWS à ConversionActionCategory pour prendre en charge le suivi des utilisateurs qui regardent une annonce et regardent plus tard une vidéo sur la même chaîne.

Génération de demande :

  • Ajout du champ DemandGenVideoResponsiveAdInfo.companion_banner.

  • Suppression du champ lead_form_only de DemandGenMultiAssetAdInfo.

Incitations :

  • Ajout de la prise en charge des incitations Choisissez votre propre (CYO), permettant aux partenaires de récupérer et d'appliquer par programmation les incitations Google Ads pour leurs clients :

  • La méthode FetchIncentive permet de récupérer les incitations disponibles pour un utilisateur, en fonction du pays, de la langue et éventuellement de l'adresse e-mail de l'utilisateur. Cela peut renvoyer des options d'incitation personnalisées « Choisissez votre propre » (CYO).

  • La méthode ApplyIncentive permet d'appliquer une incitation sélectionnée par l'utilisateur à un compte client Google Ads spécifique.

  • Ajout de la ressource en lecture seule AppliedIncentive, interrogeable via GoogleAdsService.Search et GoogleAdsService.SearchStream. Il fournit des détails sur les incitations échangées, y compris leur statut, la progression de leur exécution, les montants des récompenses et les dates pertinentes.

  • Ajout de nouveaux codes d'erreur dans IncentiveErrorEnum pour gérer les problèmes liés à la récupération ou à l'application des incitations.

  • Ajout de INVALID_EMAIL_ADDRESS à AuthenticationErrorEnum.

  • Pour faciliter une gestion programmatique plus granulaire des échecs, nous ajouterons des codes d'erreur supplémentaires à IncentivesService dans les prochaines versions. Nous vous recommandons de surveiller les annonces à venir et les notes de publication pour ces nouveaux codes d'erreur afin de vous assurer que vos applications peuvent gérer ces nouveaux modes de défaillance.

Planification:

  • Ajout de LIFE_EVENT_USER_INTEREST à AudienceInsightsDimension. Cette nouvelle dimension permet aux utilisateurs de créer des audiences à l'aide d'événements de vie pour les méthodes suivantes :

  • La réponse ReachPlanService.GenerateConversionRates inclut désormais des surfaces, permettant différentes suggestions de taux de conversion basées sur les contrôles de surface (par exemple, Gmail, Shorts). Ceci n'est pris en charge que pour les campagnes Demand Gen.

  • Ajout de LanguageDistribution à YouTubeChannelInsights, fournissant une distribution linguistique dans le contenu de la chaîne YouTube.

  • Ajout de BenchmarksService pour comparer les données publicitaires YouTube aux références du secteur.

  • Ajout de AudienceInsightsService.GenerateAudienceDefinition pour traduire une description en texte libre d'un public cible en attributs d'audience correspondants à l'aide de l'IA générative.

  • Ajout de YouTubeChannelInsights.relevance_score, qui évalue la pertinence d'un créateur pour un sujet pondéré par les vues.

  • Ajout de TrendInsightMetrics.trend_change_percent, qui représente la variation en pourcentage de la valeur d'une tendance au cours de la période de comparaison.

Recommandations :

  • Ajout du champ is_new_customer à GenerateRecommendationsRequest. Lorsqu'il est défini sur true pour les recommandations de type CAMPAIGN_BUDGET, il génère des recommandations à l'aide d'un modèle pour les nouveaux clients. Ceci n'est recommandé que pour les clients sans campagne.

Rapports :

  • Métriques et segmentation : AdGroupAdAssetView et AdGroupAdAssetCombinationView prennent désormais en charge les métriques d'impression, de performances et de conversion pour RESPONSIVE_DISPLAY_AD.

  • Métriques et segmentation : ajout du segment ad_sub_network_type pour une répartition plus granulaire des performances au sein d'un réseau publicitaire. Dans un premier temps, ceci est disponible pour les campagnes DemandGen sur YouTube (In-stream, In-feed, Shorts). Ce segment doit être sélectionné avec ad_network_type.

  • Métriques et segmentation : activation de la répartition des types de réseaux publicitaires pour les campagnes Performance Max.

  • Métriques et segmentation : UserLocationView et GeographicView prennent désormais en charge les métriques segmentées par date de conversion :

  • Nouveaux segments pour les annonces verticales

  • Nouvelles vues : ajout de PerStoreView pour interroger les détails de l'emplacement du magasin. Ajout de MatchedLocationInterestView pour les campagnes AI Max, fournissant des mesures de performances ventilées par emplacements géographiques pour lesquels les utilisateurs ont manifesté leur intérêt.

  • Performance Max : activation de la répartition des types de réseaux publicitaires pour les campagnes Performance Max.

  • Suppressions : suppression des métriques globales des étiquettes de performances des actifs. L’énumération du label de performances n’est plus renvoyée pour la recherche et le display.

Achats:

  • ShoppingPerformanceView prend désormais en charge les métriques suivantes segmentées par date de conversion : conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.

  • ShoppingPerformanceView prend désormais en charge les métriques concurrentielles suivantes : search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.

  • Ajout de product_image_uri à ShoppingProduct.

Annonces verticales :

  • Ajout de vertical_ads_format_setting aux campagnes AdGroup pour le Réseau de Recherche utilisant des flux de voyage, permettant de contrôler les formats d'annonces pouvant être diffusés.

  • Ajout du type de critère vertical_ads_item_group_rule_list à AdGroupCriterion. Ajout de vertical_ads_item_group_rule à SharedCriterion. Ces critères permettent de cibler des groupes d'articles dans les campagnes sur le Réseau de Recherche avec des flux de voyage.

  • Vous pouvez désormais connecter un flux de données d'annonces verticales à une campagne de recherche qui exécute AI Max afin qu'elle affiche des annonces de voyage de promotion de propriété et de lien de réservation à côté de vos annonces textuelles. Au niveau du groupe d'annonces, vous pouvez contrôler les formats à afficher avec vertical_ads_format_setting et définir un ensemble de règles de groupe d'articles pour cibler un sous-ensemble de vos entités à partir du flux de données d'annonces verticales. De plus, les rapports peuvent désormais être segmentés à la fois par AdFormatType et par dimensions à partir du flux de données des annonces verticales.

Vidéo:

  • Ajout du champ AdVideoAssetInfo.ad_video_asset_feature_control.

  • Ajout du code d'erreur CampaignCriterionError.INVALID_VIDEO_LINEUP_ID.

  • Ajout de mesures d'audibilité pour les publicités audio sur YouTube, indiquant si une publicité était audible et sur combien d'impressions l'audibilité pouvait être mesurée.

Discussion sur le forum sur LinkedIn.

L'équipe IBS Paris
L'équipe IBS Paris

IBS Paris, fondée en 2011, est pionnière dans l'intégration de l'innovation et du digital au cœur de son enseignement en école de commerce. Elle cultive une communauté étudiante engagée, favorisant l'excellence et le travail d'équipe. Ce creuset d’ambition prépare ses étudiants à devenir des leaders éclairés dans le monde du commerce global.