Notes de version

Consultez la page Fonctionnalités abandonnées pour obtenir la liste à jour des fonctionnalités actuelles et prévues qui seront abandonnées.

Versions majeures et mineures de v24

L'API Google Ads v24 inclut les nouvelles fonctionnalités, mises à jour et modifications incompatibles suivantes.

Version 24.2 (24/06/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées à la version 24.2 de l'API Google Ads. Les versions mineures, comme la version 24.2, ne contiennent pas de modifications majeures.

Fonctionnalités et actualités Type Description
Annonces
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT Nouvelle valeur enum Génère des informations textuelles à partir de la page de destination, qui seront affichées dans le panneau d'engagement pour les instances DemandGenVideoResponsiveAd (activées par défaut à partir de cette version de l'API).
Éléments
AssetGroup.google_local_services_info Nouveau champ Ajout de la prise en charge des informations sur les annonces Local Services (ID de catégorie et accroches) dans les campagnes Performance Max.
AssetGroupSignal.local_services_id Nouveau champ Ajout de la prise en charge des signaux d'ID de service Annonces Local Services dans les campagnes Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list Nouveau champ Ajout de règles de groupe d'articles pour les annonces verticales permettant de sélectionner des articles à partir de flux verticaux associés dans les campagnes Performance Max. Cette fonctionnalité n'est disponible que pour les comptes figurant sur la liste d'autorisation.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN Nouvelle valeur enum / erreur Retourné lorsque vous tentez de supprimer tous les groupes de composants d'une campagne.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Nouvelle valeur enum / erreur Retourné lors d'une tentative de suppression de tous les signaux d'un groupe de composants.
Campagnes
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 Nouveaux champs Aide à identifier les campagnes Performance Max pour les services locaux.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps Nouveau champ Inclut Google Maps dans les canaux sélectionnables pour les groupes d'annonces Demand Gen.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Nouvelle valeur enum / erreur Retournée lorsque vous tentez de supprimer tous les lieux d'une campagne Performance Max pour les services de proximité.
SmartCampaignErrorEnum.CREATION_FAILED Nouvelle valeur enum / erreur Retournée lorsque vous tentez de créer des campagnes intelligentes.
Conversions
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 Nouvelles valeurs enum Représentent les conversions qui se produisent lorsqu'un utilisateur clique sur une annonce Local Services et appelle, envoie un message ou réserve un service auprès de l'annonceur.
Tests
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 Nouvelles valeurs enum Ajout de la compatibilité avec de nouveaux types de ExperimentType :
  • COMPARE_CAMPAIGNS : pour les tests de combinaisons de campagnes et les tests Performance Max personnalisés qui comparent plusieurs campagnes de même type ou de types différents dans un seul test.
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : pour les tests d'optimisation Performance Max concernant l'adaptation du texte et l'extension d'URL finale.
Général
Asset.synthetic_content_info
Ad.synthetic_content_info		 Nouveaux champs Contenir des attestations pour les contenus synthétiques/générés par IA, réparties en advertiser_input (déclarations fournies directement par l'annonceur) et system_input (attestations détectées automatiquement ou fournies par le système).

Cette fonctionnalité a été rétroportée vers les versions 23 et 22.

Pour vous aider à planifier votre prochaine intégration pour la version 25, l'interface permettant de modifier les champs d'attestation de l'annonceur est introduite plus tôt pour la version 22 et les versions ultérieures. L'interface est visible dans ces versions, mais synthetic_content_info.advertiser_attestation.status et synthetic_content_info.advertiser_attestation.source resteront immuables pour ces versions.

Si vous tentez d'envoyer une requête de mutation sur l'un de ces champs, l'une des erreurs suivantes sera renvoyée :

"Le champ que vous avez essayé de modifier est immuable" ou "Le champ ne peut pas être défini".

Ces champs deviendront entièrement modifiables à partir de la version 25. Nous vous recommandons d'utiliser l'interface dès maintenant pour créer et tester votre logique interne afin que votre système soit prêt pour les fonctionnalités d'écriture complètes lors du lancement de la version 25.
Autorisation multipartite Nouvelles fonctionnalités Ajout de la compatibilité avec les examens d'autorisation multipartite (MPA) :
Cette fonctionnalité a été rétroportée vers les versions v23.3, v22.2 et v21.2.
IncentiveService.FetchIncentive Changement de comportement Lorsqu'une adresse e-mail non valide est fournie dans la requête, la méthode renvoie désormais les offres d'incitation par défaut au lieu de générer une erreur AuthenticationError.INVALID_EMAIL_ADDRESS.
Planification
GenerateCreatorInsightsRequest.search_topics Nouveau champ Ajouté au service ContentCreatorInsightsService.GenerateCreatorInsights. Cette option recherche les créateurs qui parlent d'un thème dans le pays spécifié dans country_locations (vous ne pouvez rechercher qu'un seul pays).
CREATOR_TOPIC_INSIGHTS Nouvelle valeur enum Ajouté à InsightsKnowledgeGraphEntityCapabilities pour indiquer les entités permettant de rechercher des créateurs qui parlent d'un sujet. Ces entités doivent être utilisées dans le champ search_topics. Récupéré à l'aide de AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions Nouveau type / nouvelles options Contient des options de recherche supplémentaires pour les thèmes dans ListAudienceInsightsAttributes, y compris des options permettant de récupérer tous les thèmes compatibles en tant qu'attributs de créateur et de filtrer par fonctionnalités.
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 Nouveaux champs Entrées facultatives pour les méthodes ContentCreatorInsightsService. Si vous renseignez ce champ, des attributs de créateur ou des lieux supplémentaires seront ajoutés à la réponse.
local_creator_insights
related_local_creators		 Nouveaux champs Renseigné lorsque supplemental_data contient l'énumération LOCAL_CREATOR_DATA. Affiche les créateurs locaux qui ont été regardés dans le pays choisi ou qui y sont basés et qui ont accepté de partager leurs données de localisation.
GenerateTrendingInsightsRequest.sub_country_locations Nouveau champ Ajouté à ContentCreatorInsightsService.GenerateTrendingInsights, ce qui permet de rechercher des insights sur les tendances en utilisant des pays et des régions.
Rapports
PerformanceMaxPlacementView Extension Segments ad_network_type a rendu ce contenu segmentable.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads Nouveau champ Si la valeur est "true", les exclusions de marques sont ignorées pour les annonces Shopping. Uniquement disponible pour les campagnes Shopping.
Ciblage
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE Nouvelle valeur enum / erreur Est renvoyé lorsque vous tentez de cibler une langue non autorisée.
Vidéos
DataLink.youtube_link_metadata Nouveau champ Contient brand_channel_id pour spécifier l'ID de la chaîne YouTube associée à la marque.

v24.1 (13/05/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées à la version 24.1 de l'API Google Ads. Les versions mineures, comme la version 24.1, ne contiennent pas de modifications majeures.

Fonctionnalités et actualités Type Description
Annonces
DemandGenMultiAssetAdInfo.classic_display_images Nouveau champ Images display personnalisées importées diffusées sans nécessiter de composants responsifs supplémentaires.
Tests
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING		 Nouvelles valeurs enum Ajout de la compatibilité avec de nouveaux types de ExperimentType :
  • ADOPT_AI_MAX : pour les tests qui évaluent dans quelle mesure AI Max peut vous aider à engager plus de clients grâce à l'IA de Google et aux mots clés en requête large.
  • ADOPT_BROAD_MATCH_KEYWORDS : pour les tests qui évaluent l'impact des mots clés en requête large sur le nombre de recherches dans lesquelles vos annonces s'affichent.
  • OPTIMIZE_ASSETS : pour les tests personnalisés permettant d'optimiser les composants.
  • PMAX_REPLACEMENT_SHOPPING : pour les tests qui comparent les performances de vos campagnes Shopping à celles de Performance Max.
Experiment.video_experiment Nouveau champ Assistance pour la configuration des tests YOUTUBE_CUSTOM existants composés de campagnes vidéo.
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 Nouveaux champs Expose les champs pour prendre en charge les tests de composants, les groupes de composants et les paramètres Performance Max dans les bras de test :
  • asset_testing_info : détails des composants associés aux copies expérimentales des annonces.
  • asset_groups : liste des groupes de composants dans le groupe de test pour les tests "Optimiser les composants".
  • performance_max_experiment_arm_info : paramètres des campagnes Performance Max dans les tests PMAX_REPLACEMENT_SHOPPING.
Général
CustomerUserAccess.passkey_enabled Nouveau champ Champ en lecture seule indiquant si l'utilisateur a activé une clé d'accès.
Rapports
mobile_device_platform Nouveau segment Permet de segmenter les rapports par plate-forme de l'appareil de l'utilisateur (iOS ou Android, par exemple).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED Nouvelle valeur enum / erreur Cette erreur s'affiche lorsque la précision temporelle quotidienne, horaire ou hebdomadaire demandée n'est pas acceptée pour les plages de dates de la requête (disponible uniquement pour les 37 derniers mois).
vertical_ads_listing_user_rating
vertical_ads_listing_venue		 Nouveaux segments Nouveaux segments à utiliser pour les annonces sectorielles.
user_rating, venue, event_participant_display_name Nouveaux critères de filtrage Filtrage compatible dans VerticalAdsItemGroupRuleInfo pour la ressource SharedCriterion.
Métriques des tests avec groupe de contrôle/traitement Nouveaux champs Valeurs de contrôle ajoutées (control_clicks, etc.), valeurs de traitement (clicks, etc.), estimations ponctuelles (clicks_point_estimate, etc.), marges d'erreur (clicks_margin_of_error, etc.) et valeurs p (clicks_p_value, etc.) pour sept familles de métriques principales (clics, impressions, coût, conversions, coût par conversion, valeur de conversion et valeur de conversion/coût).
Métriques de variation absolue des conversions Nouveaux champs Prise en charge des estimations de la différence absolue Conversions à l'aide des champs "Estimation ponctuelle", "Marge d'erreur" et "Valeur p".
Ciblage
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Nouvelle valeur enum / erreur Retourné lorsque vous tentez d'exclure toutes les cibles démographiques.
Vidéos
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Nouvelle valeur enum ZEFR a été publié en tant que partenaire d'intégration de la visibilité tierce.
DataLink.youtube_video.channel_id Nouveau champ Expose l'ID de la chaîne YouTube associée à l'association de données.

v24 (22/04/2026)

Les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes ont été ajoutées à la version 24 de l'API Google Ads, qui est une version majeure.

Pour obtenir de l'aide, consultez Passer à la dernière version.

Modifications importantes

État initial Nouvel état Type de modification Instructions relatives à la mise en œuvre
Annonces
Facultatif videos et logo_images dans DemandGenVideoResponsiveAdInfo Champs obligatoires Changement de comportement Fournissez videos et logo_images lorsque vous créez ou modifiez des annonces vidéo responsives Demand Gen.
Facultatif videos, business_name et logo_images dans VideoResponsiveAdInfo Champs obligatoires Changement de comportement Fournissez videos, business_name et logo_images lorsque vous créez ou modifiez des annonces vidéo responsives. Notez que VideoResponsiveAdInfo est désormais mutable.
Campagnes
Campaign.video_brand_safety_suitability Aucun Suppression Le contrôle de l'adéquation au niveau de la campagne est supprimé. La brand safety est toujours disponible au niveau du client. Utilisez plutôt Customer.video_brand_safety_suitability.
Conversions
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Aucun Suppression La catégorie d'utilisateurs "Inscriptions au programme de fidélité" a été supprimée. Supprimez les références de code à celui-ci.
Planification
Type InsightsAudienceAttributeGroup pour topic_audience_combinations Type : common.InsightsAudienceAttributeGroup Changement de comportement / de type Les intégrations de bibliothèques clientes typées doivent être mises à jour pour utiliser les nouveaux espaces de noms de ressources.
Champ youtube_select_lineups dans ReachPlanService.ListPlannableProducts Aucun Suppression Passez à l'utilisation de lineups à partir de youtube_select_lineup_targeting.
Champ is_brand_connect_creator dans ContentCreatorInsightsService.GenerateCreatorInsights et GenerateTrendingInsights Aucun Suppression Vérifiez plutôt si un créateur propose CREATOR_PARTNERSHIPS dans partnership_opportunities.
geo_modifiers et biddable_keywords dans KeywordPlanIdeaService.GenerateKeywordForecastMetrics geo_target_constants et keywords Renommer / Supprimer Remplacé par CampaignToForecast.geo_target_constants[] et ForecastAdGroup.keywords[].
Champs obsolètes du plan / des prévisions de mots clés dans GenerateKeywordForecastMetrics Aucun Suppression Suppression des champs et types de plans / prévisions suivants : Mettez à jour les intégrations en conséquence.
Rapports
Segment ad_sub_network_type dans campaign_budget Aucun Suppression Suppression du segment ad_sub_network_type pour la ressource campaign_budget.
Segment click_type dans les vues des composants Aucun Suppression Segment supprimé des vues AdGroupAsset, CampaignAsset et CustomerAsset.
Vidéos
Échec partiel autorisé dans ShareablePreviewService.GenerateShareablePreviews Aucun échec partiel Changement de comportement Les requêtes échoueront et généreront une erreur si la validation d'un ID qu'elles contiennent échoue.
Anciens codes ShareablePreviewError : MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 Renommer / Changement de comportement Les codes d'erreur renvoyés pour les groupes de composants sont modifiés pour correspondre aux erreurs d'annonces au niveau des groupes d'annonces. Mise à jour de la logique de détection de la validation.

Fonctionnalités et mises à jour (non critiques)

Fonctionnalités et actualités Type Description
Annonces
Mutabilité de VideoResponsiveAdInfo Changement de comportement Les objets d'informations sur les annonces vidéo responsives sont désormais modifiables.
Éléments
travel_feed_data dans AssetSet Nouveau champ Ajouté pour récupérer les attributs des composants du flux de voyage (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Campagnes
Campaign.view_through_conversion_optimization_enabled Nouveau champ Permet d'activer l'optimisation des conversions après affichage (VTC) (par défaut false) dans les campagnes Demand Gen et pour applications.
CampaignCriterion.gender Nouvelle fonctionnalité Exclusions de genre activées pour les campagnes Performance Max dans toutes les versions de l'API Google Ads.
Conversions
Types de conversions pour la génération de prospects Nouvelles valeurs enum Ajout de nouveaux énumérations de type d'action de conversion GA4/Firebase dans ConversionActionType :
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
Général
UserListErrorEnum.DUPLICATE_LOOKALIKE Nouvelle valeur enum / erreur Cette erreur s'affiche lorsque vous essayez de créer plusieurs listes similaires identiques.
Planification
Champs ProductCoreAttributes dans ListPlannableProductsResponse Nouveaux champs Ajout de la description du produit planifiable, de l'objectif marketing, du modèle de coût et de la méthode d'achat à ProductCoreAttributes sous ListPlannableProductsResponse.
Rapports
CartDataSalesView Nouvelle ressource de création de rapports Affiche des rapports segmentant les métriques de conversion par produit vendu spécifique (marque, etc.) en plus du produit sur lequel l'utilisateur a cliqué.
Métriques non enchérissables Nouveaux champs Ajout de métriques non enchérissables (métriques affichant les conversions pour lesquelles les campagnes ne sont pas optimisées) à toutes les ressources correspondantes :
conversion_attribution_event_type Nouveau segment Ajoutée à ShoppingPerformanceView.
Shopping
Campagnes pour applications dans ShoppingProduct Nouvelle fonctionnalité Campagnes pour applications compatibles dans la ressource ShoppingProduct. L'état et les problèmes liés aux notes ne sont pas acceptés.
Filtrage des produits basé sur les tags Nouvelle fonctionnalité Filtrage introduit à l'aide d'expressions d'ensemble logique de manière dynamique : Cette fonctionnalité n'est disponible que pour les comptes figurant sur la liste d'autorisation.

Versions majeures et mineures de v23

L'API Google Ads v23 inclut les nouvelles fonctionnalités, mises à jour et modifications incompatibles suivantes.

Version 23.3 (24/06/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées à l'API Google Ads v23.3. Les versions mineures, comme la version 23.3, ne contiennent pas de modifications majeures.

Fonctionnalités et actualités Type Description
Général
Asset.synthetic_content_info
Ad.synthetic_content_info		 Nouveaux champs Contenir des attestations pour les contenus synthétiques/générés par IA, réparties en advertiser_attestation (déclarations fournies directement par l'annonceur) et system_attestation (attestations détectées automatiquement ou fournies par les systèmes de Google).

Pour vous aider à planifier votre prochaine intégration pour la version 25, l'interface permettant de modifier les champs d'attestation de l'annonceur est introduite plus tôt pour la version 22 et les versions ultérieures. L'interface est visible dans ces versions, mais synthetic_content_info.advertiser_attestation.status et synthetic_content_info.advertiser_attestation.source resteront immuables pour ces versions.

Si vous tentez d'envoyer une requête de mutation sur l'un de ces champs, l'une des erreurs suivantes sera renvoyée :

"Le champ que vous avez essayé de modifier est immuable" ou "Le champ ne peut pas être défini".

Ces champs deviendront entièrement modifiables à partir de la version 25. Nous vous recommandons d'utiliser l'interface dès maintenant pour créer et tester votre logique interne afin que votre système soit prêt pour les fonctionnalités d'écriture complètes lors du lancement de la version 25.
Approbations multipartites Nouvelles fonctionnalités Ajout de la compatibilité avec les examens d'approbation multipartite (APM) :

Version 23.2 (25/03/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées à l'API Google Ads v23.2. Les versions mineures, comme la version 23.2, ne contiennent pas de modifications majeures.

Fonctionnalités et actualités Type Description
Éléments
VideoEnhancement Nouvelle ressource Contient des informations spécifiques aux améliorations des annonces vidéo, par exemple si elles ont été générées par Google ou fournies par l'annonceur. Pour en savoir plus, consultez À propos des améliorations vidéo.
AppTopCombinationView Nouvelle ressource Ressource en lecture seule qui fournit des insights sur les combinaisons de composants les plus performantes dans les campagnes pour applications.
CustomerAsset Nouvelle fonctionnalité Ajout de la prise en charge de la récupération de CustomerAsset avec field_type défini sur BUSINESS_LOGO.
Campagnes
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 Nouveaux champs Fournissez des contraintes de planification plus précises sur les dates de la campagne. Cette fonctionnalité n'est disponible que pour certains types de groupes d'annonces.
HotelSettingInfo.disable_hotel_setting Nouveau champ Permet de désactiver le flux d'hôtels dans les campagnes de génération de la demande.
Général
CustomerClientLinkError Nouvelles valeurs / erreurs enum Ajout de deux nouveaux codes d'erreur : MAX_CUSTOMER_LIMIT_REACHED et ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Changement de comportement Une erreur est désormais générée lorsque vous tentez d'utiliser cette catégorie de type de client de liste d'utilisateurs abandonnée.
Planification
GenerateTrendingInsights
GenerateCreatorInsights		 Nouvelles fonctionnalités Ajout de la prise en charge des combinaisons AND/OR personnalisées d'entités, de thèmes et d'audiences.
ReachPlanService.GenerateReachForecast Nouvelles valeurs enum Ajout de nouvelles tranches d'âge ciblables, telles que AGE_RANGE_21_44 ou AGE_RANGE_21_49.
youtube_select_lineup_targeting Nouveau champ Ajouté à ReachPlanService.ListPlannableProducts, qui remplacera youtube_select_lineups. Les deux champs sont actuellement renseignés.
ReachPlanSurface Nouvelle valeur enum Ajout de IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS comme option de surface.
Forecast Nouveau champ Ajout de clicks pour "Maximiser les clics" (CPC) dans les campagnes Demand Gen dans ReachPlanService.GenerateReachForecast.
partnership_opportunities Nouveau champ Ajouté à ContentCreatorInsightsService.GenerateCreatorInsights et à ContentCreatorInsightsService.GenerateTrendingInsights.
Rapports
biddable_indirect_install_first_in_app_conversion_micros Nouveau champ Ajouté aux ressources Campaign, Customer et AdGroup.
Vidéos
ShareablePreviewService Nouvelle fonctionnalité Étendu pour prendre en charge les aperçus YouTube En direct en définissant preview_type sur YOUTUBE_LIVE_PREVIEW. Ajout de UNSUPPORTED_AD_TYPE et TOO_MANY_RESOURCES_IN_REQUEST à ShareablePreviewError. Cette option n'est disponible que pour certains types d'annonces.

Version 23.1 (25/02/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées à l'API Google Ads v23.1. Les versions mineures, comme la version 23.1, ne contiennent pas de modifications destructives.

Fonctionnalités et actualités Type Description
Gestion des comptes
advertising_partner_properties.allowed_domain Nouveau champ Ajouté aux ressources ProductLinkInvitation et ProductLink. Le partenaire publicitaire ne pourra diffuser des annonces que sur ce domaine.
Customer.contains_eu_political_advertising Nouveau champ Récupère l'état de la déclaration au niveau du compte indiquant si celui-ci contient de la publicité à caractère politique ciblant l'UE et renvoie un EuPoliticalAdvertisingStatus.
Campagnes
Campaign.text_guidelines Nouveau champ Ajout de la compatibilité avec les consignes de rédaction, qui peuvent être utilisées avec les campagnes Performance Max et sur le Réseau de Recherche pour contrôler de manière programmatique les composants texte générés par l'IA. Dans text_guidelines, vous pouvez définir term_exclusions et messaging_restrictions.
CampaignPrimaryStatusReason Nouvelles valeurs enum Ajout de CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED et BOOKING_CANCELLED pour fournir les principales raisons d'état des campagnes utilisant la stratégie d'enchères FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 Nouveaux champs Ajout de la prise en charge de la divulgation par l'utilisateur de la catégorie d'annonces par réservation et des informations de réservation en lecture seule.
Campaign.missing_eu_political_advertising_declaration Nouveau champ Permet d'interroger et de filtrer les campagnes pour lesquelles il manque des déclarations indiquant si elles contiennent de la publicité à caractère politique ciblant l'UE.
Conversions
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Nouvelle valeur enum Permet de suivre les utilisateurs qui regardent une annonce, puis une vidéo de la même chaîne.
Général
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Nouvelle valeur enum / erreur Retournée lorsque vous tentez de cibler uniquement la catégorie "Indéterminé" dans les dimensions démographiques.
Avantages
IncentiveErrorEnum Nouvelles valeurs / erreurs enum Ajout de deux nouveaux codes d'erreur : MAX_INCENTIVES_REDEEMED et ACCOUNT_TOO_OLD. Ces erreurs peuvent être renvoyées pour les demandes effectuées à partir du 11 mars 2026.
Planification
GenerateBenchmarksMetrics Nouvelle fonctionnalité Ajout de la compatibilité avec les répartitions par date à l'aide de BreakdownDefinition.
ReachPlanService.GenerateReachForecast Nouvelle valeur enum Ajout de GOOGLE_DISPLAY_NETWORK en tant que surface ciblable pour les campagnes Demand Gen "Maximiser les conversions".
GenerateTrendingInsights Nouveaux champs Ajout d'informations sur la courbe de tendance historique dans TrendInsightDataPoint à TrendInsights lors d'une recherche par thème.
Rapports
Métriques de fréquence des utilisateurs uniques Nouveaux champs Ajout de nouvelles métriques indiquant le nombre d'utilisateurs ayant vu votre annonce au moins deux, trois, quatre, cinq ou dix fois : unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus et unique_users_ten_plus.
SearchTermMatchSource Nouvelle valeur enum Ajout de VERTICAL_ADS_DATA_FEED pour prendre en charge les flux de données d'annonces verticales, comme le ciblage d'entités des annonces de voyage.
YouTubeVideoUpload
YouTubeVideoUpload Nouveau service / nouvelle ressource Ajout du service YouTubeVideoUpload pour permettre l'importation et la gestion de vidéos sur YouTube, et de la ressource YouTubeVideoUpload pour permettre la récupération de l'état d'importation et des métadonnées. Cette fonctionnalité n'est disponible que pour REST et la bibliothèque cliente Python.

v23 (28/01/2026)

Les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes ont été ajoutées à la version 23 de l'API Google Ads, qui est une version majeure.

Pour obtenir de l'aide, consultez Passer à la dernière version.

Modifications importantes

État initial Nouvel état Type de modification Instructions relatives à la mise en œuvre
Annonces
Partage d'annonces autorisé AdGroupAdError.AD_SHARING_NOT_ALLOWED Changement de comportement Le partage d'annonces entre plusieurs groupes d'annonces n'est plus autorisé. Les requêtes qui tentent de partager des annonces renvoient une erreur AD_SHARING_NOT_ALLOWED.
Prise en charge de CallAd et CallAdInfo Aucun Suppression L'assistance pour les annonces Appel a été supprimée. Consultez l'article du centre d'aide À propos des annonces Appel.
Campagnes
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 Renommer / Remplacer Utilisez les nouveaux champs de date et d'heure pour spécifier les composants temporels des campagnes. Les champs d'origine contenant uniquement des dates sont supprimés.
Génération de la demande
DemandGenMultiAssetAdInfo.lead_form_only Aucun Suppression Le champ lead_form_only a été supprimé. Mettez à jour les références dans votre code.
Rapports
Agréger les métriques et l'énumération des libellés de performances des composants Aucun Suppression Suppression des métriques de libellé de performances agrégées des composants. L'enum du libellé de performances n'est plus renvoyé pour le Réseau de Recherche et Display.

Fonctionnalités et mises à jour (non critiques)

Fonctionnalités et actualités Type Description
Annonces
AdFormatType Nouvelles valeurs enum Ajout de nouveaux types de formats : TEXT, VERTICAL_ADS_BOOKING_LINK et VERTICAL_ADS_PROMOTION.
Éléments
asset_group vue Nouveaux champs Ajout des métriques suivantes : metrics.engagements, metrics.engagement_rate et metrics.average_cpe.
asset_group_asset vue Nouveaux champs Ajout des métriques suivantes : metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views et metrics.interaction_event_types.
Asset.orientation Nouveau champ Ajout d'un champ d'orientation en lecture seule aux composants Image et Vidéo.
CampaignAsset Nouvelle fonctionnalité Ajout de la prise en charge de la récupération des composants de campagne avec field_type défini sur HEADLINE et DESCRIPTION.
ServedAssetFieldType Nouvelles valeurs enum 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 pour les composants diffusés en tant que liens annexes.
BusinessMessageAsset Nouvelles fonctionnalités / assistance Composants Message à un établissement mis à jour :
Facturation
InvoiceService.ListInvoices Nouvelles options Il est désormais possible d'obtenir des informations plus précises dans Invoice, y compris la répartition des coûts au niveau de la campagne, les coûts réglementaires détaillés et les informations sur les ajustements, en définissant include_granular_level_invoice_details dans ListInvoicesRequest.
RegulatoryFeeType
UnitOfMeasure		 Nouvelles énumérations Ajout d'énums d'assistance pour les frais liés à la réglementation et les unités de mesure.
Campagnes
CampaignError Nouvelles valeurs / erreurs enum Ajout des codes d'erreur DURATION_TOO_LONG_FOR_TOTAL_BUDGET et END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Conversions
ConversionActionCategory Nouvelle valeur enum Ajout de YOUTUBE_FOLLOW_ON_VIEWS pour permettre le suivi des utilisateurs qui regardent une annonce, puis une vidéo de la même chaîne.
Génération de la demande
DemandGenVideoResponsiveAdInfo.companion_banner Nouveau champ Ajout de la prise en charge des bannières associées dans les annonces vidéo responsives Demand Gen.
Avantages
Ajout de la prise en charge des incitations "Choisissez votre propre" :

Pour faciliter la gestion programmatique plus précise des échecs, nous ajouterons des codes d'erreur à IncentivesService dans les prochaines versions. Nous vous recommandons de surveiller les prochaines annonces et notes de version concernant ces nouveaux codes d'erreur pour vous assurer que vos applications peuvent gérer ces nouveaux modes d'échec.
Planification
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST Nouvelle valeur enum Permet de créer des audiences à l'aide des événements de la vie dans GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport et GenerateCreatorInsights.

Les événements de vie ne sont pas compatibles avec les autres méthodes AudienceInsightsService telles que AudienceInsightsService.GenerateAudienceOverlap et AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates Nouveaux champs / nouvelles options La réponse inclut désormais des surfaces permettant de prendre en charge les suggestions de taux de conversion basées sur les contrôles de surface (par exemple, Gmail, Shorts). Uniquement disponible pour les campagnes de génération de la demande.
LanguageDistribution Nouveau champ / type Ajouté à YouTubeChannelInsights pour fournir des informations sur la répartition des langues dans le contenu des chaînes YouTube.
BenchmarksService Nouveau service Compare les données publicitaires YouTube aux benchmarks du secteur.
AudienceInsightsService.GenerateAudienceDefinition Nouvelle méthode Traduit une description en texte libre d'une audience cible en attributs d'audience correspondants à l'aide de l'IA générative.
YouTubeChannelInsights.relevance_score Nouveau champ Évalue la pertinence d'un créateur pour un thème, pondérée par le nombre de vues.
TrendInsightMetrics.trend_change_percent Nouveau champ Représente la variation en pourcentage de la valeur d'une tendance au cours de la période de comparaison.
Recommandations
GenerateRecommendationsRequest Nouveau champ Ajout de is_new_customer Lorsqu'il est défini sur true pour les recommandations CAMPAIGN_BUDGET, il utilise un modèle optimisé pour les nouveaux clients (recommandé uniquement pour les clients sans campagne).
Rapports
AdGroupAdAssetView Prise en charge de nouvelles fonctionnalités / métriques Les métriques d'impression, de performances et de conversion sont désormais disponibles pour RESPONSIVE_DISPLAY_AD.
Segment ad_sub_network_type Nouveau segment Fournit une analyse détaillée des performances au sein d'un réseau publicitaire. Initialement disponible pour les campagnes de génération de la demande sur YouTube (InStream, In-Feed, Shorts). Doit être sélectionné avec ad_network_type.
Rapports Performance Max Nouvelle fonctionnalité Répartition des types de réseaux publicitaires activés pour les campagnes Performance Max.
UserLocationView
GeographicView		 Compatibilité avec les nouveaux segments Métriques d'assistance 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, cross_device_conversions_by_conversion_date et cross_device_conversions_value_by_conversion_date.
Segments d'annonces verticales Nouveaux segments Ajout des segments suivants : vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account et vertical_ads_vertical.
PerStoreView
MatchedLocationInterestView		 Nouvelles ressources de reporting Ajout de PerStoreView pour interroger les détails sur les établissements et de MatchedLocationInterestView (pour les campagnes AI Max) pour fournir des métriques de performances par zones géographiques d'intérêt.
Shopping
ShoppingPerformanceView Prise en charge de nouvelles métriques Les métriques suivantes sont désormais disponibles, segmentées par date de conversion : conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date et value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView Prise en charge de nouvelles métriques Ajout de la compatibilité avec search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share et search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri Nouveau champ Ajoutée à ShoppingProduct.
Annonces verticales
AdGroup.vertical_ads_format_setting Nouveau champ Permet de contrôler les formats d'annonces pouvant être diffusés dans les campagnes sur le Réseau de Recherche utilisant des flux de voyage.
AdGroupCriterion
SharedCriterion		 Nouveaux champs / critères Ajout du type de critère vertical_ads_item_group_rule_list à AdGroupCriterion et vertical_ads_item_group_rule à SharedCriterion pour permettre le ciblage des groupes d'articles dans les campagnes sur le Réseau de Recherche avec des flux de voyage.
Intégration des flux de données relatives aux annonces verticales Nouvelle fonctionnalité Vous pouvez désormais associer un flux de données d'annonces sectorielles à une campagne sur le Réseau de Recherche utilisant AI Max pour diffuser des annonces de voyage avec lien de réservation et de promotion de propriétés en plus des annonces textuelles. Contrôlez les formats avec vertical_ads_format_setting et définissez des règles à l'aide de vertical_ads_item_group_rule. Rapports par segment par AdFormatType et dimensions du flux de données relatives aux annonces verticales.
Vidéos
AdVideoAssetInfo.ad_video_asset_feature_control Nouveau champ Ajout d'options de contrôle des fonctionnalités pour les composants d'annonces vidéo.
CampaignCriterionError Nouvelle valeur enum / erreur Ajout du code d'erreur INVALID_VIDEO_LINEUP_ID.
Métriques d'audibilité YouTube Nouvelles métriques Ajout de métriques d'audibilité pour les annonces audio sur YouTube, indiquant si une annonce était audible et pour combien d'impressions l'audibilité a pu être mesurée.

Versions majeures et mineures de v22

L'API Google Ads v22 inclut les nouvelles fonctionnalités, mises à jour et modifications incompatibles suivantes.

v22.2 (24/06/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées à l'API Google Ads v22.2. Les versions mineures, comme la version 22.2, ne contiennent pas de modifications majeures.

Fonctionnalités et actualités Type Description
Général
Asset.synthetic_content_info
Ad.synthetic_content_info		 Nouveaux champs Contenir des attestations pour les contenus synthétiques/générés par IA, réparties en advertiser_attestation (déclarations fournies directement par l'annonceur) et system_attestation (attestations détectées automatiquement ou fournies par les systèmes de Google).

Pour vous aider à planifier votre prochaine intégration pour la version 25, l'interface permettant de modifier les champs d'attestation de l'annonceur est introduite plus tôt pour la version 22 et les versions ultérieures. L'interface est visible dans ces versions, mais synthetic_content_info.advertiser_attestation.status et synthetic_content_info.advertiser_attestation.source resteront immuables pour ces versions.

Si vous tentez d'envoyer une requête de mutation sur l'un de ces champs, l'une des erreurs suivantes sera renvoyée :

"Le champ que vous avez essayé de modifier est immuable" ou "Le champ ne peut pas être défini".

Ces champs deviendront entièrement modifiables à partir de la version 25. Nous vous recommandons d'utiliser l'interface dès maintenant pour créer et tester votre logique interne afin que votre système soit prêt pour les fonctionnalités d'écriture complètes lors du lancement de la version 25.
Approbations multipartites Nouvelles fonctionnalités Ajout de la compatibilité avec les examens d'approbation multipartite (APM) :

v22.1 (25/02/2026)

La nouvelle fonctionnalité suivante a été ajoutée à l'API Google Ads v22.1. Les versions mineures, comme la version 22.1, ne contiennent pas de modifications destructives.

Fonctionnalités et actualités Type Description
Gestion des comptes
Customer.contains_eu_political_advertising Nouveau champ Récupère l'état de la déclaration au niveau du compte indiquant si celui-ci contient de la publicité à caractère politique ciblant l'UE et renvoie un EuPoliticalAdvertisingStatus.
Campagnes
Campaign.missing_eu_political_advertising_declaration Nouveau champ Permet d'interroger et de filtrer les campagnes pour lesquelles il manque des déclarations indiquant si elles contiennent de la publicité à caractère politique ciblant l'UE.

v22 (15/10/2025)

Les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes ont été ajoutées à la version 22 de l'API Google Ads, qui est une version majeure.

Pour obtenir de l'aide, consultez Passer à la dernière version.

Modifications importantes

État initial Nouvel état Type de modification Instructions relatives à la mise en œuvre
Génération de la demande
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Renommer / Corriger l'orthographe Renommez les références pour utiliser le nom de champ corrigé.
Général
Aucune limite d'opérations dans AddBatchJobOperations Limite de 10 000 opérations par requête Changement de comportement Assurez-vous qu'aucune requête AddBatchJobOperations ne contient plus de 10 000 opérations.
Taille de page limitée à 1 000 dans ListBatchJobResultsRequest Erreur INVALID_PAGE_SIZE renvoyée Changement de comportement Assurez-vous que ListBatchJobResultsRequest.page_size est défini sur 1 000 ou moins, car une taille de page plus grande générera désormais une erreur.
Performance Max
Libellés de performances des composants Aucun Suppression La compatibilité avec les libellés de performances des composants et l'énumération des libellés de performances associée ont été supprimées pour les campagnes Performance Max. Mettez à jour les intégrations en conséquence.
Campaign.url_expansion_opt_out Option FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION dans AssetAutomationSetting Enlèvement / Remplacement Utilisez le paramètre d'automatisation des composants Texte pour l'extension d'URL finale. Le champ de désactivation de l'extension d'URL au niveau de la campagne a été supprimé.
Planification
views trueview_views Enlèvement / Remplacement Remplacez les références à views par le nouveau champ trueview_views dans ReachPlanService.
Vidéos
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts		 trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts		 Renommages Mettez à jour les chaînes de requête et les intégrations pour utiliser les nouveaux noms de métriques représentant les vues de vidéo TrueView.

Fonctionnalités et mises à jour (non critiques)

Fonctionnalités et actualités Type Description
Éléments
AssetFieldType.LANDING_PAGE_PREVIEW Nouvelle valeur enum Ajouté en tant que nouveau type de champ de composant Image.
AssetGenerationService Nouveau service (bêta) Permet de générer des composants Texte et Image à l'aide de l'IA générative :
  • GenerateText : génère du texte en fonction de l'URL finale, des requêtes, des mots clés, etc.
  • GenerateImages : génère des images en fonction de l'URL finale, des requêtes ou de la recontextualisation des images de produits.
  • Les erreurs sont renvoyées avec des codes de AssetGenerationError.
Initialement disponible uniquement pour un nombre limité de participants à la bêta fermée.
Campagnes
AppCampaignBiddingStrategyGoalType Nouvelles valeurs enum Nous avons ajouté de nouveaux objectifs aux campagnes pour applications axées sur les installations (CAi) afin de vous permettre d'optimiser vos campagnes sans spécifier de cible :
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : à utiliser avec la stratégie standard "Maximiser les conversions".
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : à utiliser avec la stratégie standard "Maximiser la valeur de conversion".
BiddingStrategyType Nouvelle fonctionnalité Ajout de la compatibilité avec le type de stratégie d'enchères "Part de voix fixe".
Campaign.feed_types Nouveau champ Indique les types de flux associés à une campagne. Pour les campagnes Performance Max, cela peut indiquer le secteur d'activité, par exemple MERCHANT_CENTER_FEED pour le commerce.
Ciblage par ensemble partagé Nouvelle fonctionnalité Il est désormais possible d'associer des ensembles partagés de mots clés à exclure aux campagnes multicanaux (pour les campagnes pour applications) et locales.
Génération de la demande
Enchères au CPC cible Nouvelle fonctionnalité Ajout d'une stratégie d'enchères pour maximiser les clics au CPC cible : définissez le CPC cible au niveau de la campagne à l'aide de Campaign.target_cpc et remplacez-le au niveau du groupe d'annonces à l'aide de AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES Nouvelle valeur enum Si cette option est activée pour DemandGenMultiAssetAdInfo, elle ajoute des éléments de conception et intègre des composants Texte dans des composants Image pour créer de nouveaux composants Image avec différents formats (activée par défaut).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS Nouvelle valeur enum Si elle est activée pour DemandGenMultiAssetAdInfo, elle génère des vidéos à partir d'autres composants tels que des images et du texte, qui peuvent ensuite être utilisés pour créer de nouvelles instances DemandGenVideoResponsiveAdInfo (activées par défaut).
Général
Taille de page de secours ListBatchJobResultsRequest Changement de comportement Si page_size n'est pas défini ou est défini sur 0, il est désormais défini par défaut sur la valeur maximale de 1 000 (auparavant,INVALID_PAGE_SIZE était renvoyé).
QuotaError Nouvelle valeur enum / erreur Ajout de PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED pour indiquer quand la limite de fréquence d'activation du profil de paiement est dépassée.
Performance Max
Paramètres d'automatisation des composants Nouvelles valeurs enum Ajout de nouvelles options d'automatisation des composants PMax :
  • GENERATE_IMAGE_ENHANCEMENT : active la création automatique d'images améliorées (recadrage automatique). Cette option est activée par défaut.
  • GENERATE_IMAGE_EXTRACTION : images provenant des URL finales. La valeur par défaut est le paramètre d'extension d'image dynamique du compte.
Segments de rapports PMax Nouveaux segments Ajout de nouveaux segments propres aux campagnes Performance Max :
Planification
Listes de données de partenaires CRM Nouvelle fonctionnalité / valeur enum Ajout de THIRD_PARTY_PARTNER_DATA aux sources de données CRM, ainsi que des codes d'erreur de validation d'audience partenaire (tels que l'acceptation des conditions d'utilisation, le lien manquant, etc.).
Métriques sur les créateurs de diffusions en direct Nouveau champ Ajout de YouTubeMetrics.is_active_live_stream_creator, renvoyé par les insights sur les créateurs pour indiquer si un créateur a publié une diffusion en direct au cours des 90 derniers jours.
Métadonnées de la source CRM planifiables Nouveau message Ajout de PlannableUserListMetadata dans PlannableUserList, renvoyé par ReachPlanService.ListPlannableUserLists, pour afficher les types de sources de données CRM.
Compatibilité avec les vidéos et les créateurs associés dans TrendInsight Nouveaux champs Ajout de la prise en charge de related_videos et related_creators sur TrendInsight, et des propriétés de surveillance dans video_properties et publish_date.
Améliorations apportées à InsightsFinder Nouvelle fonctionnalité GenerateInsightsFinderReport est désormais compatible avec parental_status, income_ranges et les combinaisons de ciblage ET/OU plus complexes.
Rapports
Nouveaux types de clics Nouvelles valeurs enum Ajout de CLICK_TO_MESSAGE_THIRD_PARTY_CLICK et de CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
Segmentation AssetGroupAsset Compatibilité avec les nouveaux segments AssetGroupAsset peut désormais être segmenté par device, conversion_action, conversion_action_name et conversion_action_category.
ARR dans AdGroupAdAssetView Prise en charge de nouvelles fonctionnalités / métriques AdGroupAdAssetView est désormais entièrement compatible avec les métriques de performances et de conversions pour RESPONSIVE_SEARCH_AD (auparavant, seules les impressions étaient renvoyées).
Segmentations des métriques de cluster de requêtes d'exploration Compatibilité avec les nouveaux segments Les métriques clicks_unique_query_clusters, conversions_unique_query_clusters et impressions_unique_query_clusters peuvent désormais être segmentées par champs de date.
TargetingExpansionView Nouvelle ressource de création de rapports Ajout de TargetingExpansionView pour générer des métriques sur les élargissements par rapport au ciblage manuel, comme l'élargissement sans mot clé pour AI Max pour les campagnes sur le Réseau de Recherche.
Shopping
Correction du champ d'application Shopping Correction de bug Correction de la portée des métriques au niveau de la campagne et du groupe d'annonces dans la ressource ShoppingProduct.
Objectifs unifiés
Objectifs de rétention Nouvelle fonctionnalité Ajout de la compatibilité avec les objectifs de fidélisation des clients pour optimiser le réengagement des clients existants (par exemple, en utilisant target_option avec TARGET_SPECIFIC ou TARGET_ALL).
Vidéos
Métriques sur la durée de visionnage des vidéos Nouveaux champs Ajout de métriques sur la durée de visionnage : video_watch_time_duration_millis (durée totale) et average_video_watch_time_duration_millis (durée moyenne par impression).

Versions majeures et mineures de v21

L'API Google Ads v21 inclut les nouvelles fonctionnalités, mises à jour et modifications incompatibles suivantes.

Version 21.2 (24/06/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées à l'API Google Ads v21.2. Les versions mineures, comme la version 21.2, ne contiennent pas de modifications majeures.

Fonctionnalités et actualités Type Description
Général
Approbations multipartites Nouvelles fonctionnalités Ajout de la compatibilité avec les examens d'approbation multipartite (APM) :

Version 21.1 (25/02/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées à l'API Google Ads v21.1. Les versions mineures, comme la version 21.1, ne contiennent pas de modifications destructives.

Fonctionnalités et actualités Type Description
Gestion des comptes
Customer.contains_eu_political_advertising Nouveau champ Récupère l'état de la déclaration au niveau du compte indiquant si celui-ci contient de la publicité à caractère politique ciblant l'UE et renvoie un EuPoliticalAdvertisingStatusEnum.
Campagnes
Campaign.missing_eu_political_advertising_declaration Nouveau champ Permet d'interroger et de filtrer les campagnes pour lesquelles il manque des déclarations indiquant si elles contiennent de la publicité à caractère politique ciblant l'UE.

v21 (06/08/2025)

Les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes ont été ajoutées à la version 21 de l'API Google Ads, qui est une version majeure.

Pour obtenir de l'aide, consultez Passer à la dernière version.

Modifications importantes

État initial Nouvel état Type de modification Instructions relatives à la mise en œuvre
Campagnes
Renvoie CriterionError.INVALID_LISTING_GROUP_HIERARCHY Renvoie CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION Modification du code d'erreur Pour les requêtes avec échec partiel activé, gérez le nouveau code d'erreur au lieu du code d'erreur de hiérarchie d'origine.
Conversions
Accès au mode debug_enabled dans ConversionUploadService Aucun Suppression Le champ debug_enabled est supprimé. Mettez à jour le code qui le référence pour qu'il ne définisse ni n'interroge ce paramètre.
Modifications apportées à la publicité à caractère politique dans l'UE
Déclarations facultatives concernant les campagnes pour les annonces à caractère politique dans l'UE Champ obligatoire contains_eu_political_advertising pour les nouvelles campagnes Règle de validation / changement de comportement Les appels d'API visant à créer des campagnes échoueront et renverront une erreur FieldError.REQUIRED si ce champ n'est pas défini. À partir du 22 septembre 2025, les campagnes déclarées comme CONTAINS_EU_POLITICAL_ADVERTISING ne seront plus diffusées dans l'UE.
Critères modifiables sans autodéclaration Échec des mises à jour avec CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Règle de validation / changement de comportement Définissez l'état de l'auto-déclaration avant de tenter de créer ou de mettre à jour des critères de ciblage par proximité, par zone géographique ou par groupe de zones géographiques au niveau de la campagne ou du groupe d'annonces pour les campagnes existantes.
Tests sans obligation d'autodéclaration Échec des mises à jour avec ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Règle de validation / changement de comportement Assurez-vous que les auto-déclarations ont été effectuées pour les campagnes du test.
Performance Max
brand_guidelines_enabled est défini par défaut sur false. La valeur par défaut est true. Changement de comportement Pour les nouvelles campagnes Performance Max, les consignes relatives à la marque sont activées par défaut. Définissez explicitement le champ sur false si les fonctionnalités doivent être désactivées.
Planification
Type d'argument d'entrée d'origine pour AudienceInsightsService.GenerateTargetingSuggestionMetrics Entrée de type InsightsAudience Changement de type Mettez à jour les implémentations pour transmettre le nouveau type d'entrée qui accepte une combinaison AND-of-ORs des centres d'intérêt des utilisateurs, ce qui permet d'obtenir des métriques de couverture potentielles pour les définitions d'audience personnalisées.

Fonctionnalités et mises à jour (non critiques)

Fonctionnalités et actualités Type Description
AI Max pour les campagnes sur le Réseau de Recherche
ai_max_setting.enable_ai_max dans Campaign Nouveau champ Permet à AI Max d'étendre la correspondance des termes de recherche (en respectant l'automatisation des composants texte et les listes de marques précédentes jusqu'à ce qu'elles soient désactivées). Le champ Campaign.ai_max_setting.bundling_required indique si AI Max doit être activé pour respecter/modifier ces paramètres, et AdGroup.ai_max_ad_group_setting.disable_search_term_matching peut désactiver la correspondance au niveau du groupe d'annonces. Consultez Améliorer vos performances grâce à AI Max pour les campagnes sur le Réseau de Recherche.
CampaignError.AI_MAX_MUST_BE_ENABLED Nouvelle valeur enum / erreur Cette erreur se produit lorsque vous activez l'automatisation des composants Texte pour l'extension d'URL dans les campagnes sur le Réseau de Recherche sans activer AI Max.
Ciblage au niveau du groupe d'annonces Nouvelle fonctionnalité Ajout de la compatibilité avec les listes de marques, les zones géographiques et les pages Web (règles d'URL) au niveau du groupe d'annonces dans les campagnes AI Max sur le Réseau de Recherche.
ai_max_search_term_ad_combination_view Nouvelle ressource de création de rapports Indique les performances des combinaisons de termes de recherche, de titres et de pages de destination.
Segment search_term_match_type Nouvelle valeur enum Ajout de AI_MAX comme option de type de correspondance des termes de recherche.
Éléments
PromotionAsset Nouveaux champs Ajout des options terms_and_conditions_text, terms_and_conditions_uri et oneof promotion_trigger (promotion_barcode_info, promotion_qr_code_info). Consultez À propos des composants Promotion.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION Nouvelle valeur enum Ajouté à AssetAutomationType pour contrôler la génération automatique de texte et de pages de destination à partir des URL finales dans les campagnes sur le Réseau de Recherche.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset Nouveau service / nouvelle méthode Permet de supprimer les composants d'extension d'URL finale créés automatiquement dans les campagnes.
ServedAssetFieldType.DESCRIPTION_PREFIX Nouvelle valeur enum Ajouté pour corriger un problème de création de rapports où le type était renvoyé en tant que UNKNOWN dans ad_group_ad_asset_combination_view.
Campagnes
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING Nouvelle valeur enum Retourné lorsque les campagnes à diffusion limitée géographiquement ne disposent pas de ciblage géographique (qui génère désormais LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN si elles sont ciblées en dehors de la zone autorisée).
Intégration d'une solution d'analyse d'applications tierce Nouveaux champs Ajout de la compatibilité avec VideoCustomer.third_party_integration_partners et Campaign.third_party_integration_partners. Consultez Effectuer le suivi des conversions d'application avec une solution d'analyse d'applications tierce.
Campaign.advertising_partner_ids Prise en charge de nouveaux champs Le champ peut désormais être défini pour les campagnes existantes (il reste immuable une fois défini).
Emplacements à exclure au niveau du compte administrateur Nouvelle fonctionnalité Permet d'exclure des listes d'emplacements dans des comptes d'annonceurs individuels à l'aide de CustomerNegativeCriterion.
Configurations de la tolérance dans les stratégies "ROAS cible" Nouveaux champs Ajout de la prise en charge de TargetRoas.target_roas_tolerance_percent_millis (pour les stratégies de portefeuille de campagnes sur le Réseau de Recherche) dans MaximizeConversionValue et TargetRoas.
LocationInterestView Nouvelle ressource de création de rapports Résume les performances des critères de lieux d'intérêt au niveau du groupe d'annonces.
Conversions
Segment conversion_attribution_event_type Nouvelle valeur enum Ajout de ENGAGED_VIEW aux options de type d'attribution de conversion.
Génération de la demande
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM Nouvelle valeur enum / erreur Ajouté en vue de l'application de budgets quotidiens minimaux pour les campagnes de génération de la demande. Les détails sont exposés à l'aide de budgetDailyMinimumErrorDetails.
Performance Max
campaign_search_term_view Nouvelle ressource de création de rapports Agrège les métriques des termes de recherche au niveau de la campagne, ce qui permet d'analyser les termes de recherche et de générer des rapports pour Performance Max.
Planification
ReachPlanService.ListPlannableUserInterests Nouvelle méthode Permet de découvrir les affinités planifiables et les centres d'intérêt sur le marché pour generateReachForecast.
AdditionalApplicationInfo Nouveau champ Ajouté en tant qu'entrée facultative dans ReachPlanService.ListPlannableUserLists.
Liste des attributs Audience Insights Nouvelle fonctionnalité AudienceInsightsService.ListAudienceInsightsAttributes récupère désormais les listes d'utilisateurs propriétaires disponibles.
AudienceCompositionInsights ciblant les listes CRM Nouvelle fonctionnalité AudienceInsightsService.GenerateAudienceCompositionInsights renvoie désormais les détails de l'index de la liste des utilisateurs pour les dimensions AudienceInsightsDimension : AGE_RANGE, GENDER, AFFINITY_USER_INTEREST et IN_MARKET_USER_INTEREST.
Part d'audience TrendInsightMetrics Nouveau champ Représente la part d'audience d'une tendance.
KnowledgeGraphAttributeMetadata catégories Nouveaux champs Filtre les attributs Knowledge Graph par catégories correspondantes.
Rapports
Métriques sur les vues des composants Nouvelles fonctionnalités / métriques Ajout de plusieurs métriques à AssetGroupAsset, ChannelAggregateAssetView et CampaignAggregateAssetView. Les campagnes PMax indiquent désormais les valeurs réelles pour impressions.
Extensions de sélecteur Nouvelle fonctionnalité Les requêtes AssetSet et CampaignAssetSet peuvent désormais être exécutées ensemble dans ChangeStatus.
search_term_targeting_status Nouveau segment Segment sélectionnable dans la vue "Termes de recherche de la campagne".
final_url_expansion_asset_view Nouvelle ressource de création de rapports Fournit des informations détaillées sur les performances des composants avec extension d'URL finale.
Ajustements de la valeur des groupes de composants Nouveaux champs Ajout de la prise en charge des métriques value_adjustment et all_value_adjustment dans le rapport AssetGroup.
landing_page_source Nouveau segment Fournit un segment de source de page de destination dans landing_page_view.
search_term_match_source Nouveau segment Segment sélectionnable dans les vues "Termes de recherche" et "Termes de recherche de la campagne".
match_type Nouveau segment Clé de segment sélectionnable dans la vue des mots clés.
Rapports sur les clusters d'intention de requête uniques Nouveaux champs Ajout de clicks_unique_query_clusters, conversions_unique_query_clusters et impressions_unique_query_clusters pour signaler les clusters d'intention de requête uniques.
ClickType.VEHICLE_ASSETS Nouvelle valeur enum Suivez et signalez les clics spécifiquement liés aux formats d'annonces de véhicules dans le rapport click_view.
Exploration avec stratégies d'enchères intelligentes
Configurations de tolérance dans les stratégies de recherche Nouveaux champs / paramètres Permet d'activer l'exploration avec stratégies d'enchères intelligentes dans les campagnes sur le Réseau de Recherche en définissant target_roas_tolerance_percent_millis entre 10 000 (10%) et 30 000 (30%), inclus (le paramètre target_roas est requis pour "Maximiser les conversions"). Consultez notre article de blog sur l'exploration des stratégies d'enchères intelligentes et notre article du Centre d'aide.
Compatibilité des rapports sur la diversité Nouvelle fonctionnalité Les rapports agrégés sur la diversité sont désormais disponibles pour les métriques suivantes concernant les clusters d'intention de requête unique. Une vue segmentée par période est disponible dans l'UI Google Ads :
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
Vidéos
YouTubeVideoListAsset Nouvelle ressource / nouveau champ Permet d'établir des associations entre des campagnes et des composants Liste de vidéos à l'aide de Asset.youtube_video_list_asset. Consultez Utiliser des vidéos similaires.
Extensions de métadonnées des insights Nouveaux champs Ajout de nouvelles métadonnées à YouTubeChannelInsights et YouTubeVideoAttributeMetadata.
Types de clics interactifs Nouvelles valeurs enum Ajout des types de clics suivants : VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK et PRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream Nouveau champ Permet de diffuser des annonces vidéo responsives en tant qu'annonces InStream non désactivables pour les campagnes qui utilisent à la fois des formats désactivables et non désactivables.
Paramètres de séquencement vidéo Nouveaux champs Ajout de configurations de séquençage en lecture seule : Campaign.VideoCampaignSettings.video_ad_sequence et VideoAdSequenceStepSetting. Consultez À propos du séquencement des annonces vidéo.
Ciblage de lineups vidéo Nouveau type / champ de critère Ajout du type de critère VIDEO_LINEUP et du champ correspondant dans CampaignCriterion et AdGroupCriterion. Cette fonctionnalité n'est disponible que pour les comptes figurant sur la liste d'autorisation.
Vues des emplacements d'adéquation du contenu Nouvelles ressources de reporting Ajout d'un rapport sur l'adéquation du contenu aux niveaux détaillé (detail_content_suitability_placement_view) et groupé (group_content_suitability_placement_view). Consultez À propos du rapport "Adéquation du contenu".

Notes de version archivées

Consultez Versions abandonnées pour accéder aux notes de version archivées.