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 la v25

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

v25.2 (23/09/2026)

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

Fonctionnalités et nouveautés Type Description
Éléments
Options d'URL pour AssetGroup Nouveaux champs Ajout de la compatibilité avec les options d'URL sur AssetGroup, permettant aux annonceurs de spécifier des modèles de suivi, des paramètres personnalisés et des suffixes d'URL finale au niveau du groupe de composants :
Campagnes
Informations sur l'exploration automatisée des vidéos Nouveaux champs et énumérations Ajout de AutomatedVideoCrawlSetting à Campaign.AssetAutomationSetting, ainsi que de AssetAutomationType.AUTOMATED_VIDEO_CRAWL, pour vous permettre de spécifier les paramètres d'exploration vidéo automatique pour une campagne Performance Max. AutomatedVideoCrawlSetting.automated_video_crawl_infos contient une liste d'entrées AutomatedVideoCrawlInfo, chacune configurant un url d'exploration, source_platform (VideoCrawlSourcePlatform : LANDING_PAGE, SOCIAL ou YOUTUBE) et l'état d'activation enabled.
Erreurs liées au multiplicateur de valeur d'optimisation du cycle de vie client Nouvelles valeurs d'énumération et erreurs Ajout de nouveaux motifs d'erreur de validation lors de la configuration des multiplicateurs de valeur (value_multiplier et high_lifetime_value_multiplier) pour l'optimisation du cycle de vie client :
SmartCampaignSettingService.GeneratePMaxDraftCampaign Nouvelle fonctionnalité Ajout de SmartCampaignSettingService.GeneratePMaxDraftCampaign pour permettre la génération d'une campagne brouillon Performance Max à partir d'une campagne intelligente existante, initialisée avec l'état CampaignStatus.PAUSED et l'état de création CampaignCreationStatus.INCOMPLETE (voir Convertir des campagnes intelligentes en campagnes Performance Max) :
Conversions
Impressions d'annonces Firebase Nouveaux types et catégories d'actions de conversion Les types d'actions de conversion FIREBASE_ANDROID_APP_AD_IMPRESSION et FIREBASE_IOS_APP_AD_IMPRESSION sont désormais disponibles. Vous pouvez donc récupérer et modifier ces actions de conversion. La catégorie IN_APP_AD_REVENUE est également exposée dans ConversionActionCategory pour suivre les revenus de monétisation des annonces dans une application.
Général
BusinessProfileLocationSyncError Nouvelle énumération et nouvelles erreurs Ajout de motifs pour les erreurs de synchronisation des établissements de fiches d'établissement lors de la synchronisation des établissements dans un AssetSet de type LOCATION_SYNC. Au lieu de renvoyer une erreur UNKNOWN générique, l'API renvoie désormais BusinessProfileLocationSyncError avec des motifs spécifiques (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED et NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Planification
Métriques de centiles BenchmarksService.GenerateBenchmarksMetrics Nouvelles fonctionnalités

Mise à jour de BenchmarksService.GenerateBenchmarksMetrics pour fournir des métriques représentant la position concurrentielle du client par rapport aux autres annonceurs sous forme de centiles. Les métriques sont renvoyées dans PercentileMetrics sur le nouveau champ CustomerMetrics.percentile_metrics (sur GenerateBenchmarksMetricsResponse.customer_metrics et BreakdownMetrics.customer_metrics) et représentées à l'aide de BenchmarksCustomerPercentileTier.

CustomerMetrics.percentile_metrics n'est renseigné que lorsque les deux conditions suivantes sont remplies dans GenerateBenchmarksMetricsRequest :

Ajout de la prise en charge des métriques de centiles pour les dates de trimestre ouvert dans ListBenchmarksAvailableDatesResponse.supported_dates (renvoyées par BenchmarksService.ListBenchmarksAvailableDates). Alors que les métriques agrégées des clients (CustomerMetrics.aggregate_metrics), les métriques de taux des clients (CustomerMetrics.average_rate_metrics) et les métriques de centiles des clients (CustomerMetrics.percentile_metrics) sont compatibles avec toutes les dates dans supported_dates (y compris les trimestres ouverts), les métriques de part de marché des clients (CustomerMetrics.share_metrics) et les métriques de taux de la source des benchmarks (average_benchmarks_metrics, comme average_cpm des annonces "/Apparel/Clothing") ne sont pas compatibles avec les trimestres ouverts et sont omises de la réponse, sauf si le date_range demandé se trouve dans la plage plus étroite ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics.

Pour améliorer l'expérience utilisateur, nous avons ajouté une erreur BenchmarksError.NO_METRICS_FOUND personnalisée qui indique qu'aucune métrique n'a été trouvée pour la combinaison d'entrées sélectionnée.
Identifiants de chaîne YouTube pour les insights sur les créateurs Nouvelle fonctionnalité Mise à jour de ContentCreatorInsightsService.GenerateCreatorInsights pour permettre la recherche par identifiant de chaîne YouTube à l'aide de YouTubeChannels.youtube_channel_handles (les identifiants de chaîne valides doivent commencer par @, comme @channel_handle). Cette option est semblable à la recherche par ID de chaîne YouTube. La réponse contient des insights sur les créateurs YouTube demandés.
Recommandations
Recommandations d'enchères au CPA et au ROAS Nouvelles recommandations Ajout de Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) et Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), ainsi que de ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low et ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, pour permettre d'augmenter le CPA cible ou de diminuer le ROAS cible lorsque les enchères sont trop basses pour que les campagnes sur le Réseau de Recherche participent aux enchères :
Rapports
Segments de dimension des séjours d'hôtel Nouveaux segments Ajout des segments de dimension suivants pour les itinéraires de réservation d'hôtels et de voyages à Segments (sélectionnables avec campaign, ad_group et customer) :
Métriques des annonces verticales Nouvelles métriques Ajout des métriques suivantes pour les rapports sur les annonces d'hôtels et de voyages à Metrics (sélectionnables avec campaign, ad_group et customer) :
Segments d'annonces verticales Nouveaux segments Ajout des segments suivants pour les rapports sur les annonces de voyage et d'hôtels dans Segments (sélectionnables avec campaign, ad_group et customer) :

v25.1 (19/08/2026)

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

Fonctionnalités et nouveautés Type Description
Éléments
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 Nouvelles valeurs enum Ajout de la prise en charge des composants de clause de non-responsabilité textuelle.
Campagnes
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 Nouveaux champs Suivez la prochaine migration automatique vers AI Max.
Conversions
Mesures du brand lift Nouvelles fonctionnalités Ajout de la compatibilité avec les mesures du brand lift grâce aux mises à jour suivantes :
Mesures du conversion lift Nouvelles fonctionnalités Nous avons ajouté la prise en charge des mesures du conversion lift avec les mises à jour suivantes :
  • Ajout d'une ressource en lecture seule LiftMeasurementConfig représentant une étude d'impact.
  • Ajout de nouveaux segments sélectionnables pour segmenter et filtrer les résultats du brand lift.
  • Ajout de 24 nouvelles métriques de conversion lift et de score du gagnant permettant une analyse statistique détaillée des performances de lift.
  • Ajout de la compatibilité pour récupérer les détails de la campagne et les objectifs de conversion.
  • Ajout d'un champ facultatif Experiment.lift_measurement_config.
  • Ajout de l'énumération ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight Nouvelle ressource Nouvelle ressource en lecture seule représentant les détails d'un vol pour une configuration de mesure de l'impact, y compris les dates de début et de fin du vol mesuré (start_date et end_date).
Général
SmartCampaignError Nouvelles valeurs enum Ajout de nouveaux codes d'erreur spécifiques pour les contraintes de génération Performance Max :
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION Nouvelle valeur enum / erreur Retourné lorsqu'un projet Google Cloud avec un niveau d'accès TEST tente d'envoyer des requêtes à un compte non test.
Planification
Insights sur le sentiment envers la marque Nouvelles fonctionnalités Ajout de la prise en charge des insights sur le sentiment de marque dans ContentCreatorInsightsService :
Améliorations BenchmarksService Nouvelles fonctionnalités Ajout de la prise en charge des catégories en tant que filtres pour définir le champ d'application d'une analyse des benchmarks. Les métriques critiques pour l'activité suivantes sont également acceptées :
Ciblage par statut parental Nouvelle fonctionnalité Ajout de la compatibilité avec le ciblage par statut parental dans la planification de la couverture. Ajout du nouveau champ parental_statuses à Targeting pour le service ReachPlanService.GenerateReachForecast et de parental_statuses à PlannableTargeting pour le service ReachPlanService.ListPlannableProducts.
Recommandations
Recommendation.campaign_specific_app_goal_recommendation Nouvelle recommandation Suggère d'ajouter un objectif de conversion d'application propre à la campagne. La nouvelle ressource EffectiveAutomaticGoal permet de représenter les objectifs actuels dans cette recommandation.
Rapports
Metrics.original_conversion_value Nouveau champ Représente la valeur de conversion d'origine des conversions enchérissables. Il s'agit de la valeur non ajustée des conversions avant l'application des ajustements de règles de valeur, comme les règles de valeur de conversion ou les ajustements d'objectifs de cycle de vie.
Statistiques sur les membres du programme de fidélité Nouvelles fonctionnalités Ajout de la possibilité de segmenter les statistiques par état du programme de fidélité des utilisateurs, et ajout de la dimension principale de fidélité pour les règles de valeur de conversion :
  • Ajout du segment Segments.loyalty_membership pour permettre de segmenter les métriques des rapports en fonction du niveau du programme de fidélité de l'utilisateur ayant effectué la conversion.
  • Ajout de la dimension principale LOYALTY_MEMBERSHIP pour identifier quand une condition d'adhésion à un programme de fidélité a été remplie pour une règle de valeur de conversion.
Ciblage
vertical_ads_item_bid Nouveau type de critère Ajout du nouveau type de critère vertical_ads_item_bid à AdGroupCriterion.criterion.

v25 (22/07/2026)

Les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes ont été ajoutées à la version 25 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
Champs autonomes additional_value et additional_high_lifetime_value dans CustomerLifecycleOptimizationValueSettings Font respectivement partie des oneofs value_adjustment et high_lifetime_value_adjustment, aux côtés des nouveaux champs value_multiplier et high_lifetime_value_multiplier Changement structurel Mettez à jour les références à ces champs, car ils font désormais partie des oneofs.
Anciennes ressources CustomerLifecycleGoal et CampaignLifecycleGoal, leurs services correspondants CustomerLifecycleGoalService et CampaignLifecycleGoalService, et anciens paramètres/énums (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) Aucun Suppression Utilisez le schéma d'objectifs unifiés remanié :
Général
Champs d'énumération imbriqués dans les messages de requête et de réponse du service d'incitation :
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Champs d'énumération autonomes : Renommer / Supprimer Utilisez les nouveaux champs d'énumération autonomes au lieu des anciens champs type.
Champs selected_incentive_id et customer_id facultatifs dans ApplyIncentiveRequest Champs obligatoires Changement de comportement Assurez-vous de fournir les deux champs lorsque vous appelez ApplyIncentive.
Champ d'adresse e-mail du consommateur ContactDetails.email dans la ressource LocalServicesLead Aucun Suppression Supprimez les références à ce champ, car il n'est plus compatible.
Champ allowed_domain facultatif dans AdvertisingPartnerLinkInvitationProperties Champ obligatoire lorsque vous appelez CreateProductLinkInvitation pour un partenaire publicitaire Changement de comportement Veillez à fournir allowed_domain lorsque vous créez une invitation à associer un produit pour un partenaire publicitaire.
Planification
Champ search_brand dans GenerateCreatorInsightsRequest Aucun Suppression Utilisez plutôt search_topics.
Le champ plannable_location_id dans Targeting et le champ cookie_frequency_cap dans GenerateReachForecastRequest Aucun Suppression Passez à l'utilisation de plannable_location_ids et cookie_frequency_cap_setting.
Rapports
Champs customer_metrics dans GenerateBenchmarksMetricsResponse et BreakdownMetrics de type Metrics Champ de type CustomerMetrics Changement de type / de comportement Mettez à jour vos intégrations pour utiliser le nouveau type CustomerMetrics, qui ne contient que des métriques représentant les performances publicitaires du client.

Fonctionnalités et mises à jour (sans rupture)

Fonctionnalités et nouveautés Type Description
Annonces
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS Nouvelle valeur / nouveau comportement enum Disponible pour DemandGenMultiAssetAds. Si cette option est activée, elle génère des images animées à partir d'images non animées. Les nouveaux DemandGenMultiAssetAds sont activés par défaut à partir de cette version de l'API.
Immuabilité des informations sur le contenu synthétique Changement de comportement Asset.synthetic_content_info et Ad.synthetic_content_info sont désormais entièrement modifiables dans les versions 25, 24 et 23.
Campagnes
Objectif de rétention (fidélisation) Nouvelles fonctionnalités / nouveaux paramètres Ajout de la prise en charge de l'objectif de rétention des membres du programme de fidélité, qui permet aux annonceurs d'optimiser leurs campagnes pour fidéliser les membres de leur programme de fidélité.
Objectif d'acquisition de nouveaux clients Nouvelles fonctionnalités / nouveaux paramètres Mise à jour de la compatibilité avec l'objectif d'acquisition de nouveaux clients dans l'API Google Ads pour refléter le nouveau schéma d'objectifs unifiés :
Conversions
Attribution des conversions tierces sur YouTube Nouveaux champs Ajout de la vérification de l'attribution des conversions YouTube à l'aide de partenaires tiers : Pour en savoir plus, consultez cet article du Centre d'aide.
Général
ContactDetails.phone_number_extension Nouveau champ Ajouté à la ressource LocalServicesLead.
IncentiveError Nouvelles valeurs d'énumération et erreurs Ajout de codes d'erreur spécifiques pour les échecs d'échange d'incitations :
Planification
Informations sur les chaînes YouTube dans les insights sur les tendances Nouveaux champs Ajout de la prise en charge de plus de détails sur les chaînes YouTube des vidéos associées lors de la recherche d'insights sur les tendances. Ajout des nouveaux champs channel_id, channel_name et channel_url à YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given Nouveau champ Ajoutée à YouTubeChannelInsights. Cela est vrai si un créateur a accepté de partager des données non publiques. Si tel est le cas, les champs suivants sont renseignés :
Rapports
ad_sub_format_type Nouveau segment Voici la répartition des annonces InStream non désactivables sur YouTube par durée : Ce segment doit toujours être sélectionné avec ad_format_type. Il peut être sélectionné avec AdGroup, AdGroupAd, Campaign, Customer, Video et VideoEnhancement.
Métriques sociales spécifiques aux vidéos Nouveaux champs / nouvelles métriques Nous avons ajouté des métriques sociales spécifiques aux vidéos pour aider les annonceurs à suivre l'engagement des utilisateurs (commentaires, "J'aime" et partages) pour les annonces Shorts sur YouTube : Elles sont disponibles dans AdGroup, AdGroupAd, Asset, Campaign, Customer et Video.

Versions majeures et mineures de v24

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

v24.2 (24/06/2026)

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

Fonctionnalités et nouveauté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 "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 d'assets d'une campagne.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Nouvelle valeur enum / erreur Retournée 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 les services 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, divisées en advertiser_attestation (déclarations fournies directement par l'annonceur) et system_attestation (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 modification 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 :
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 résident et qui ont accepté de partager leurs données de localisation.
GenerateTrendingInsightsRequest.sub_country_locations Nouveau champ Ajout de ContentCreatorInsightsService.GenerateTrendingInsights, qui permet de rechercher des insights sur les tendances en fonction du pays et des régions.
Rapports
PerformanceMaxPlacementView Extension Segments Segmentable par ad_network_type.
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 Cette erreur s'affiche 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 destructives.

Fonctionnalités et nouveautés Type Description
Annonces
DemandGenMultiAssetAdInfo.classic_display_images Nouveau champ Images display importées personnalisé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 (elle n'est disponible que pour les 37 derniers mois).
vertical_ads_listing_user_rating
vertical_ads_listing_venue		 Nouveaux segments Nouveaux segments à utiliser pour les annonces verticales.
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 Ajout de valeurs de contrôle (control_clicks, etc.), de valeurs de traitement (clicks, etc.), d'estimations ponctuelles (clicks_point_estimate, etc.), de marges d'erreur (clicks_margin_of_error, etc.) et de 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 Conversions estimations de la différence absolue à 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é tiers.
DataLink.youtube_video.channel_id Nouveau champ Expose l'ID de la chaîne YouTube associé à 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.
videos, business_name et logo_images facultatifs dans VideoResponsiveAdInfo Champs obligatoires Changement de comportement Fournissez videos, business_name et logo_images lorsque vous créez ou modifiez des annonces responsives vidéo. Notez que VideoResponsiveAdInfo est désormais mutable.
Campagnes
Campaign.video_brand_safety_suitability Aucun Suppression Le paramètre de brand suitability au niveau de la campagne est supprimé. La brand safety et la brand suitability sont toujours disponibles au niveau 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 de 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 a activé 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 l'un des ID qu'elles contiennent n'est pas validé.
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 des groupes d'annonces. Mise à jour de la logique de détection de la validation.

Fonctionnalités et mises à jour (sans rupture)

Fonctionnalités et nouveauté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 Retourné lorsque vous tentez 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 reporting Affiche des rapports segmentant les métriques de conversion par produit spécifique vendu (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 la 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 destructives.

Fonctionnalités et nouveauté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 modification 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'approbations multipartites :

v23.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 destructives.

Fonctionnalités et nouveautés Type Description
Éléments
VideoEnhancement Nouvelle ressource Contient des informations spécifiques aux annonces vidéo améliorées, 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 permettant d'obtenir 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 obsolète.
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 la stratégie "Maximiser les clics" (CPC) des 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 fonctionnalité n'est disponible que pour certains types d'annonces.

v23.1 (25/02/2026)

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

Fonctionnalités et nouveauté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 détails 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 Cette erreur s'affiche 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 prise en charge des répartitions par date à l'aide d'un 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 tendance historique dans TrendInsightDataPoint à TrendInsights lors de la 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 de l'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 uniquement.
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.
Demand Gen
DemandGenMultiAssetAdInfo.lead_form_only Aucun Suppression Le champ lead_form_only a été supprimé. Mettez à jour les références dans votre code.
Rapports
Enum et métriques de libellé de performances des composants agrégés Aucun Suppression Suppression des métriques agrégées sur les libellés de performances des composants. L'énumération du libellé de performances n'est plus renvoyée pour le Réseau de Recherche et Display.

Fonctionnalités et mises à jour (sans rupture)

Fonctionnalités et nouveauté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
Vue asset_group Nouveaux champs Ajout des métriques suivantes : metrics.engagements, metrics.engagement_rate et metrics.average_cpe.
Vue asset_group_asset 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 / nouveaux services Composants Message à un établissement mis à jour :
Facturation
InvoiceService.ListInvoices Nouvelles options Vous pouvez désormais 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.
Demand Gen
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 la 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 Il est désormais compatible avec les métriques d'impression, de performances et de conversions 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 Demand Gen 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 sur les rapports Ajout de PerStoreView pour interroger les informations sur les magasins 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 à l'aide de 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 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 d'établissements à côté 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 Annonce 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 sur 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 nouveauté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 modification 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'approbations multipartites :

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 nouveauté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
Demand Gen
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 de renvoi INVALID_PAGE_SIZE 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 Suppression / 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 Suppression / 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éos TrueView.

Fonctionnalités et mises à jour (sans rupture)

Fonctionnalités et nouveauté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 pour les 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 prise en charge du 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.
Demand Gen
Enchères au CPC cible Nouvelle fonctionnalité Ajout de la stratégie d'enchères "Maximiser les clics" au CPC cible : définition du CPC cible au niveau de la campagne à l'aide de Campaign.target_cpc et remplacement 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, des éléments de conception sont ajoutés et des composants Texte sont intégrés 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 à l'aide 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 égal à 0, la valeur par défaut est désormais 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. Par défaut, le paramètre d'extension d'image dynamique du compte est utilisé.
Segments de rapports PMax Nouveaux segments Ajout de nouveaux segments propres aux campagnes Performance Max :
  • ad_using_product_data : indique si une annonce utilise les données produit de Google Merchant Center.
  • ad_using_video : indique si une annonce utilise un composant vidéo.
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 de l'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 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é des vidéos et des 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 reporting 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 les campagnes AI Max pour le Réseau de Recherche.
Shopping
Correction de la portée Shopping Correction de bug Correction de la portée des métriques au niveau des campagnes et des groupes 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 des métriques de durée de visionnage : video_watch_time_duration_millis (durée totale) et average_video_watch_time_duration_millis (durée moyenne par impression).

Notes de version archivées

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