Notes de version

Consultez Fonctionnalités obsolètes pour obtenir une liste à jour des fonctionnalités obsolètes et de celles qui le seront bientôt, Calendrier d'abandon et de suppression pour connaître les dates du cycle de vie des versions, et Mettre à niveau votre version de l'API pour obtenir des tableaux filtrables des différences entre les versions de proto.

Résumé de la version et liens rapides

Utilisez le tableau suivant pour accéder directement aux modifications destructives, aux nouvelles fonctionnalités ou aux tableaux de différences de proto d'une version :

Version Date de sortie Modifications destructives Fonctionnalités et mises à jour Tableau des différences entre les protos
v26 (la plus récente) 2026-10-14 Modifications destructives de la v26 Fonctionnalités et mises à jour de la v26 Différences entre les protos v25 et v26
v25.2 2026-09-23 Aucun (version mineure) Fonctionnalités et mises à jour de la version 25.2 Différences entre les fichiers proto v24 et v25
v25.1 2026-08-19 Aucun (version mineure) Fonctionnalités et mises à jour de la version 25.1 Différences entre les fichiers proto v24 et v25
v25 2026-07-22 Modifications destructives de la v25 Fonctionnalités et mises à jour de la v25 Différences entre les fichiers proto v24 et v25
v24.2 2026-06-24 Aucun (version mineure) Fonctionnalités et mises à jour de la version 24.2 Différences entre les protos v23 et v24
v24.1 2026-05-13 Aucun (version mineure) Fonctionnalités et mises à jour de la version 24.1 Différences entre les protos v23 et v24
v24 2026-04-22 Modifications destructives de la v24 Fonctionnalités et mises à jour de la v24 Différences entre les protos v23 et v24
v23.3 2026-06-24 Aucun (version mineure) Fonctionnalités et mises à jour de la version 23.3 Différences entre les protos v22 et v23
v23.2 2026-03-25 Aucun (version mineure) Fonctionnalités et mises à jour de la version 23.2 Différences entre les protos v22 et v23
v23.1 2026-02-25 Aucun (version mineure) Fonctionnalités et mises à jour de la version 23.1 Différences entre les protos v22 et v23
v23 28/01/2026 Modifications destructives de la v23 Fonctionnalités et mises à jour de la v23 Différences entre les protos v22 et v23

Version majeure v26

La version 26 de l'API Google Ads inclut les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes.

v26 (14/10/2026)

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

Pour obtenir des conseils, consultez Passer à la dernière version.

Modifications destructives

État initial Nouvel état Type de modification Instructions relatives à la mise en œuvre
Campagnes
Champ country_code facultatif dans LocalServicesPmaxCampaignSettings Champ obligatoire lors de la création d'une campagne Performance Max pour Local Services (LocalServicesPmaxCampaignSettings.country_code) Changement de comportement Veillez à spécifier country_code (ainsi que le nouveau champ obligatoire listing_id) lorsque vous créez des campagnes Performance Max pour les services de proximité.
Conversions
Le champ enhanced_conversions_for_leads_enabled dans ConversionTrackingSetting (Customer.conversion_tracking_setting) Aucun Suppression Utilisez plutôt ConversionTrackingSetting.enablement_setting sur Customer.conversion_tracking_setting pour inspecter le paramètre de suivi avancé des conversions au niveau du compte.
Ciblage
Champs de critères spécifiques aux hôtels dans AdGroupBidModifier :
  • hotel_date_selection_type
  • hotel_advance_booking_window
  • hotel_length_of_stay (min_nights et max_nights)
  • hotel_check_in_day
  • hotel_check_in_date_range
 Champs de critères indépendants du secteur d'activité dans AdGroupBidModifier : Renommer / Supprimer Mettez à jour les références pour utiliser les champs de critères indépendants du secteur, qui permettent de cibler d'autres secteurs du voyage que les hôtels (comme les activités à découvrir). Les ID de critère, le comportement de ciblage et les modificateurs d'enchères existants restent inchangés. Les valeurs de min_nights et max_nights sont reportées telles quelles dans min_days et max_days.
HotelDateSelectionType et type de segments.user_set_dates DateSelectionType Renommer / Changer de type Utilisez DateSelectionType à la place de HotelDateSelectionType.
Motifs d'erreur spécifiques aux hôtels dans CriterionError :
  • HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY
  • HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE
  • HOTEL_CHECK_IN_DATE_RANGE_REVERSED
 Motifs d'erreur indépendants du secteur d'activité dans CriterionError : Renommer Mettez à jour la gestion des erreurs pour vérifier les nouveaux motifs d'erreur indépendants du secteur d'activité.

Fonctionnalités et mises à jour (non destructives)

Fonctionnalités et mises à jour Type Description
Éléments
Fournisseurs de messages à un établissement sur LINE et par SMS Nouveaux champs et valeurs d'énumération Ajout de la prise en charge de LINE et des SMS en tant que fournisseurs de messages dans BusinessMessageAsset, y compris les nouveaux champs BusinessMessageAsset.line_info et BusinessMessageAsset.sms_info, ainsi que BusinessMessageProvider.LINE et BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY Nouvelle valeur d'énumération / erreur Ajout de AssetGroupError pour indiquer quand une catégorie spécifiée dans GoogleLocalServicesInfo (AssetGroup.google_local_services_info) n'est pas compatible avec les campagnes Performance Max pour les services de proximité.
Campagnes
Création d'une campagne Performance Max Local Services Nouvelles fonctionnalités, nouveaux champs et nouvelles erreurs

Mise à jour de PmaxCampaignSettings.local_services_enabled de OUTPUT_ONLY à IMMUTABLE, ce qui permet aux clients API externes de spécifier local_services_enabled = true lors de la création de campagnes Performance Max Local Services.

Nous avons également ajouté LocalServicesPmaxCampaignSettings.listing_id pour exposer l'ID de la fiche d'établissement Google associée à la campagne Performance Max Local Services (marqué comme OBLIGATOIRE lors de la création de la campagne Performance Max Local Services) et le code d'erreur CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
Erreurs de validation de la campagne Local Services Nouvelles valeurs d'énumération et erreurs Ajout de nouvelles erreurs de validation pour les campagnes Local Services :
Validation de l'association du compte Hotel Center Nouvelle valeur d'énumération / erreur Ajout du code d'erreur CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED à CampaignError pour indiquer que l'association d'un ensemble de composants d'établissement hôtelier (Campaign.hotel_property_asset_set) à une campagne Performance Max pour les objectifs de voyage nécessite une association active à un compte Hotel Center.
Budget minimal par jour pour Demand Gen Nouveau champ Ajout du champ demand_gen_info.minimum_budget_per_day_micros à CurrencyConstant, qui spécifie le budget quotidien minimal requis pour les campagnes Demand Gen dans cette devise. La valeur de ce champ est mise à jour lorsque le budget minimal appliqué par l'API change.
Configuration de la mesure de l'impact pour les campagnes Nouveau champ Ajout de Campaign.lift_measurement_config pour exposer le nom de ressource de la configuration de mesure du brand lift associée à la campagne.
Validation des tests AI Max Nouvelle valeur d'énumération / erreur Ajout du code d'erreur ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED à ExperimentArmError lors de la tentative de création d'un test ADOPT_AI_MAX pour une campagne pour laquelle AI Max est déjà activé (ou est activé dans la même requête avant la création du groupe de test).
Type de fiche de campagne Shopping Assistance étendue Prise en charge étendue de Campaign.listing_type pour les campagnes Shopping.
Modifications apportées à l'autodéclaration pour la publicité à caractère politique dans l'UE Comportement mis à jour et nouveaux champs

Campaign.contains_eu_political_advertising est désormais facultatif pour certaines campagnes qui ne ciblent pas l'Union européenne.

  • Sauf indication contraire pour les campagnes DEMAND_GEN avec ciblage amélioré, le champ est facultatif si une campagne remplit toutes les conditions suivantes après l'exécution de la requête :
    • Ne contient aucun critère de campagne de ciblage géographique positif dans l'UE
    • Ne contient aucun critère de campagne de proximité ou de groupe de zones géographiques à inclure
    • Contient au moins un critère de campagne de ciblage géographique positif en dehors de l'UE
  • Pour les campagnes DEMAND_GEN avec upgraded_targeting, le champ est facultatif si chaque groupe d'annonces actif de la campagne remplit toutes les conditions suivantes une fois la requête exécutée :
    • Ne contient aucun critère de groupe d'annonces de ciblage géographique positif dans l'UE
    • Ne contient aucun critère de groupe d'annonces pour une proximité ou un groupe de zones géographiques à inclure
    • Contient au moins un critère de groupe d'annonces de zone géographique à inclure qui se trouve en dehors de l'UE
    Ce champ est également facultatif pour les campagnes sans groupe d'annonces actif. Si une requête crée un groupe d'annonces qui ne remplit pas ces conditions, AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION est renvoyé.
  • Ces modifications s'appliquent aux campagnes nouvelles et existantes. Dans certains cas, une campagne ne peut être créée que si des critères sont ajoutés dans la même requête. Utilisez GoogleAdsService.Mutate pour regrouper les mutations.
  • Mise à jour de Campaign.missing_eu_political_advertising_declaration pour refléter les modifications apportées à Campaign.contains_eu_political_advertising.
  • Ajout de GeoTargetConstant.require_eu_political_advertising_declaration pour indiquer si un emplacement se trouve dans l'UE ou en dehors.
  • Ajout de CampaignCriterion.require_eu_political_advertising_declaration et de AdGroupCriterion.require_eu_political_advertising_declaration. Campaign.contains_eu_political_advertising est obligatoire si ce champ est défini sur true pour n'importe quel critère au niveau de la campagne (ou pour n'importe quel critère actif au niveau du groupe d'annonces dans les campagnes DEMAND_GEN avec ciblage amélioré). Les champs renvoient true si le champ negative du critère est false et que le critère est une zone géographique de l'UE, une proximité (qu'elle chevauche ou non le territoire de l'UE) ou un groupe de zones géographiques (qu'il chevauche ou non le territoire de l'UE).
Conversions
Configuration unifiée du suivi avancé des conversions Nouveaux champs et énumération Ajout de ConversionTrackingSetting.enablement_setting et ConversionTrackingSetting.effective_enablement_setting (sur Customer.conversion_tracking_setting) pour exposer la configuration unifiée du suivi avancé des conversions pour le compte, représentée à l'aide de la nouvelle énumération EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD Nouvelle valeur d'énumération Ajouté à ConversionActionCategory pour prendre en charge les interactions par message ou chat indiquant un intérêt pour l'offre d'un annonceur.
ConversionAttributionEventType.CLICK Nouvelle valeur d'énumération Ajouté à ConversionAttributionEventType pour représenter les conversions attribuées à un clic sur une annonce, qui étaient auparavant incluses dans la valeur d'énumération UNKNOWN.
Général
Mises à jour des prospects Local Services Nouveau champ et nouvelle valeur d'énumération
Recommandations
Recommandation d'augmentation du budget pour le Réseau de Recherche Nouvelle recommandation Ajout de RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation et ApplyRecommendationOperation.raise_budget_performance_too_low pour permettre d'augmenter les budgets lorsque les budgets quotidiens sont trop faibles pour les campagnes sur le Réseau de Recherche.
Rapports
Mesures du search lift Nouvelles fonctionnalités, ressources, segments et métriques Ajout de la prise en charge des mesures de search lift :
Vue des composants d'extension de l'URL finale pour les campagnes Shopping Assistance étendue final_url_expansion_asset_view a été développé pour prendre en charge les campagnes Shopping (avec ad_group sélectionnable en tant que ressource attribuée avec final_url_expansion_asset_view.ad_group).
Vidéos
Signalisations des contenus génératifs sur YouTube Nouveaux champs et énumération Ajout de la prise en charge des avis de contenu génératif pour les mises en ligne sur YouTube. Le nouveau champ YouTubeVideoUpload.video_content_metadata de type VideoContentMetadata a été ajouté à YouTubeVideoUpload. Il contient les paramètres de divulgation sous VideoContentMetadata.generative_content_disclosure de type YouTubeVideoUploadGenerativeContentDisclosure.

Versions majeures et mineures de v25

La version 25 de l'API Google Ads inclut les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes.

v25.2 (23/09/2026)

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

Fonctionnalités et mises à jour Type Description
Éléments
Options d'URL pour AssetGroup Nouveaux champs Ajout de la compatibilité avec les options d'URL sur AssetGroup, ce qui permet 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, ce qui vous permet de spécifier les paramètres d'exploration vidéo automatisée pour une campagne Performance Max. AutomatedVideoCrawlSetting.automated_video_crawl_infos contient une liste d'entrées AutomatedVideoCrawlInfo, chacune configurant un url d'exploration, un source_platform (VideoCrawlSourcePlatform : LANDING_PAGE, SOCIAL ou YOUTUBE) et un état d'activation enabled.
Erreurs liées au multiplicateur de valeur pour l'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'un brouillon de campagne Performance Max à partir d'une campagne intelligente existante, initialisé avec l'état CampaignStatus.PAUSED et l'état de création CampaignCreationStatus.INCOMPLETE (voir Convertir des campagnes intelligentes en campagnes PMax) :
Conversions
Impressions d'annonces Firebase Nouveaux types et catégories d'actions de conversion Exposition des types d'actions de conversion FIREBASE_ANDROID_APP_AD_IMPRESSION et FIREBASE_IOS_APP_AD_IMPRESSION, ce qui vous permet de récupérer et de modifier ces actions de conversion. La catégorie IN_APP_AD_REVENUE a également été exposée dans ConversionActionCategory pour suivre les revenus de monétisation des annonces dans l'application.
Général
BusinessProfileLocationSyncError Nouvelle énumération et erreurs Ajout de motifs pour les erreurs de synchronisation des établissements de la fiche 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 raisons spécifiques (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED et NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Planification
BenchmarksService.GenerateBenchmarksMetrics métriques de centile 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 dans 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 compatibilité avec les métriques de centile pour les dates du trimestre ouvert dans ListBenchmarksAvailableDatesResponse.supported_dates (renvoyées par BenchmarksService.ListBenchmarksAvailableDates). Bien 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 centile des clients (CustomerMetrics.percentile_metrics) soient compatibles avec toutes les dates de supported_dates (y compris les trimestres ouverts), les métriques de part 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 la valeur date_range demandée se situe dans la plage ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics plus étroite.

Ajout d'une erreur BenchmarksError.NO_METRICS_FOUND personnalisée indiquant qu'aucune métrique n'a été trouvée pour la combinaison d'entrées sélectionnée afin d'améliorer la facilité d'utilisation.
Identifiants de chaînes 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 @, par exemple @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 réduire le ROAS cible lorsque les enchères sont trop faibles pour que les campagnes sur le Réseau de Recherche participent aux enchères :
Rapports
Segments de dimension de séjour d'hôtel Nouveaux segments Ajout des segments de dimension d'itinéraire de réservation d'hôtel et de voyage suivants à 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 des secteurs de l'hôtellerie et du voyage à 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 du secteur des hôtels et des voyages à 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 à la version 25.1 de l'API Google Ads. Les versions mineures telles que la v25.1 ne contiennent pas de modifications destructives.

Fonctionnalités et mises à jour Type Description
Éléments
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 Nouvelles valeurs d'énumération Ajout de la compatibilité avec les composants de clause de non-responsabilité textuelle.
Campagnes
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 Nouveaux champs Suivez la migration automatique vers AI Max à venir.
Conversions
Mesures du brand lift Nouvelles fonctionnalités Ajout de la compatibilité avec les mesures du brand lift, avec les mises à jour suivantes :
Mesures du conversion lift Nouvelles fonctionnalités Ajout de la compatibilité avec les mesures du conversion lift, avec les mises à jour suivantes :
  • Ajout d'une ressource en lecture seule LiftMeasurementConfig représentant une étude de l'impact.
  • Ajout de nouveaux segments sélectionnables pour segmenter et filtrer les résultats de l'étude de l'impact.
  • Ajout de 24 nouvelles métriques de conversion lift et de métriques de score gagnant permettant une analyse statistique détaillée des performances de conversion lift.
  • Ajout de la compatibilité avec la récupération des détails de la campagne et des objectifs de conversion.
  • Ajout d'un champ facultatif Experiment.lift_measurement_config.
  • Ajout de l'énumération ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight Nouvelle ressource Une nouvelle ressource en lecture seule représentant les détails de la période de diffusion pour une configuration de mesure de l'impact, y compris les dates de début et de fin de la période de diffusion mesurée (start_date et end_date).
Général
SmartCampaignError Nouvelles valeurs d'énumération 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 d'énumération / erreur Renvoyé lorsqu'un projet Google Cloud avec un niveau d'accès TEST tente d'effectuer des requêtes sur un compte autre qu'un compte de test.
Planification
Insights sur le sentiment envers la marque Nouvelles fonctionnalités Ajout de la prise en charge des insights sur l'opinion de la marque dans ContentCreatorInsightsService :
BenchmarksService amélioration 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 comparative. Autres métriques critiques pour l'entreprise également prises en charge :
Ciblage par statut parental Nouvelle fonctionnalité Ajout de la compatibilité avec le ciblage par statut parental dans Reach Planner. 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 en fonction de l'état d'adhésion au programme de fidélité, et ajout de la dimension principale d'adhésion au programme de fidélité pour les règles de valeur de conversion :
  • Ajout du segment Segments.loyalty_membership pour permettre la segmentation des métriques de rapport en fonction du niveau du programme de fidélité de l'utilisateur à l'origine de 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 majeure 25 de l'API Google Ads.

Pour obtenir des conseils, consultez Passer à la dernière version.

Modifications destructives

É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 partie des oneof value_adjustment et high_lifetime_value_adjustment respectivement, 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 de oneofs.
Anciennes ressources CustomerLifecycleGoal et CampaignLifecycleGoal, leurs services correspondants CustomerLifecycleGoalService et CampaignLifecycleGoalService, et anciens paramètres/énumérations (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 facultatifs selected_incentive_id et customer_id dans ApplyIncentiveRequest Champs obligatoires Changement de comportement Veillez à fournir les deux champs lorsque vous appelez ApplyIncentive.
Le 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 accepté.
Champ allowed_domain facultatif dans AdvertisingPartnerLinkInvitationProperties Champ obligatoire lors de l'appel de CreateProductLinkInvitation pour un partenaire publicitaire Changement de comportement Veillez à fournir allowed_domain lorsque vous créez une demande d'association de produit pour un partenaire publicitaire.
Planification
Le champ search_brand dans GenerateCreatorInsightsRequest Aucun Suppression Utilisez search_topics à la place.
Le champ plannable_location_id dans Targeting et le champ cookie_frequency_cap dans GenerateReachForecastRequest Aucun Suppression Utilisez plutôt plannable_location_ids et cookie_frequency_cap_setting.
Rapports
Champ customer_metrics dans GenerateBenchmarksMetricsResponse et BreakdownMetrics de type Metrics Champ de type CustomerMetrics Changement de type / comportement Mettez à jour vos intégrations pour utiliser le nouveau type CustomerMetrics, qui ne contient que des métriques représentant les performances des annonces du client.

Fonctionnalités et mises à jour (non destructives)

Fonctionnalités et mises à jour Type Description
Annonces
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS Nouvelle valeur d'énumération / nouveau comportement Disponible pour DemandGenMultiAssetAds. Si cette option est activée, elle génère des images animées à l'aide d'images non animées en entrée. Les nouveaux DemandGenMultiAssetAds sont activés par défaut à partir de cette version de l'API.
Mutabilité des informations sur le contenu synthétique Nouveau 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 / paramètres Ajout de la compatibilité avec 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 / paramètres Mise à jour de la compatibilité avec l'objectif d'acquisition de nouveaux clients dans l'API Google Ads pour refléter le schéma d'objectifs unifiés remanié :
Conversions
Attribution des conversions tierces sur YouTube Nouveaux champs Ajout de la compatibilité avec la validation de l'attribution des conversions YouTube à l'aide de partenaires tiers : Pour en savoir plus, consultez l'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'utilisation des incitations :
Planification
Informations sur les chaînes YouTube dans les insights sur les tendances Nouveaux champs Ajout de la prise en charge d'informations supplémentaires sur les chaînes YouTube des vidéos similaires 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. C'est le cas 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 Fournit une répartition des annonces InStream non désactivables 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 / métriques Ajout de métriques sociales spécifiques aux vidéos pour aider les annonceurs à suivre l'engagement utilisateur (commentaires, "J'aime" et partages) pour les annonces Shorts sur YouTube : Ils sont disponibles en AdGroup, AdGroupAd, Asset, Campaign, Customer et Video.

Versions majeures et mineures de la v24

La version 24 de l'API Google Ads inclut les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes.

v24.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 telles que la v24.2 ne contiennent pas de modifications destructives.

Fonctionnalités et mises à jour Type Description
Annonces
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT Nouvelle valeur d'énumération Génère des informations textuelles à partir de la page de destination à afficher dans le panneau d'engagement pour les instances DemandGenVideoResponsiveAd (qui sont activées par défaut à partir de cette version de l'API).
Éléments
AssetGroup.google_local_services_info Nouveau champ Ajouté pour prendre en charge les informations sur les annonces Local Services (ID de catégorie et accroches) dans les campagnes Performance Max.
AssetGroupSignal.local_services_id Nouveau champ Ajouté pour prendre en charge les signaux d'ID de service des annonces Local Services dans les campagnes Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list Nouveau champ Ajouté pour prendre en charge les règles de groupe d'articles des annonces verticales afin de sélectionner des articles dans les 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 d'énumération / erreur Renvoyé lorsque vous tentez de supprimer tous les groupes de composants d'une campagne.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Nouvelle valeur d'énumération / erreur Renvoyé lorsque vous tentez de supprimer tous les signaux d'un groupe de composants.
Campagnes
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 Nouveaux champs Prise en charge de l'identification des campagnes Performance Max pour les annonces Local Services.
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 d'énumération / erreur Renvoyé lorsque vous tentez de supprimer toutes les zones géographiques d'une campagne Performance Max pour les services locaux.
SmartCampaignErrorEnum.CREATION_FAILED Nouvelle valeur d'énumération / erreur Renvoyé lors d'une tentative de création de campagnes intelligentes.
Conversions
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 Nouvelles valeurs d'énumération Représentent les conversions qui se produisent lorsqu'un utilisateur clique sur une annonce Local Services, puis appelle l'annonceur, lui envoie un message ou réserve ses services.
Tests
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 Nouvelles valeurs d'énumération Ajout de la compatibilité avec de nouveaux types ExperimentType :
  • COMPARE_CAMPAIGNS : pour les tests de combinaisons de campagnes et les tests Performance Max personnalisés qui comparent plusieurs campagnes de types identiques ou différents dans un même test.
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : pour les tests d'optimisation Performance Max pour la personnalisation du texte et l'extension de l'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 l'IA, divisées en advertiser_attestation (déclarations fournies directement par l'annonceur) et system_attestation (attestations détectées ou fournies automatiquement par le système).

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

Pour vous aider à planifier votre prochain travail d'intégration pour la v25, l'interface permettant de modifier les champs d'attestation de l'annonceur est introduite plus tôt pour la v22 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'effectuer une requête de modification sur l'un de ces champs, l'une des erreurs suivantes sera renvoyée :

"Le champ que vous avez tenté de modifier est immuable" ou "Impossible de définir le champ".

Ces champs deviendront entièrement modifiables à partir de la v25. 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 v25.
Autorisation multipartite Nouvelles fonctionnalités Ajout de la prise en charge des 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 incitatives 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 sujet dans le pays spécifié dans country_locations (recherche possible pour un seul pays).
CREATOR_TOPIC_INSIGHTS Nouvelle valeur d'énumération Ajout à InsightsKnowledgeGraphEntityCapabilities pour indiquer les entités permettant de rechercher des créateurs parlant 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 fournissez ce champ, des emplacements ou des attributs de créateur supplémentaires sont renseignés dans 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 visionnés ou basés dans le pays choisi 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 à l'aide de la localisation par pays et par sous-pays.
Rapports
PerformanceMaxPlacementView Extension Segments Rendu 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. Compatible uniquement avec les campagnes Shopping.
Ciblage
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE Nouvelle valeur d'énumération / erreur 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 de marque YouTube associée.

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 telles que la v24.1 ne contiennent pas de modifications destructives.

Fonctionnalités et mises à jour Type Description
Annonces
DemandGenMultiAssetAdInfo.classic_display_images Nouveau champ Images display personnalisées importées et 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 d'énumération Ajout de la compatibilité avec de nouveaux types 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 pour lesquelles vos annonces sont diffusées.
  • OPTIMIZE_ASSETS : pour les tests personnalisés visant à 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 des champs pour prendre en charge les tests de composants, les groupes de composants et les paramètres Performance Max dans les groupes 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 d'optimisation des 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 en fonction de la plate-forme de l'appareil de l'utilisateur (iOS ou Android, par exemple).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED Nouvelle valeur d'énumération / erreur Renvoyé 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 verticales.
user_rating, venue, event_participant_display_name Nouveaux critères de filtrage Ajout de la compatibilité avec le filtrage dans VerticalAdsItemGroupRuleInfo pour la ressource SharedCriterion.
Métriques de test de contrôle/traitement Nouveaux champs Ajout des valeurs de contrôle (control_clicks, etc.), des valeurs de traitement (clicks, etc.), des estimations ponctuelles (clicks_point_estimate, etc.), des marges d'erreur (clicks_margin_of_error, etc.) et des 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, rapport valeur/coût de conversion).
Métriques de variation absolue des conversions Nouveaux champs Prise en charge des estimations de différence absolue Conversions à l'aide des champs d'estimation ponctuelle, de marge d'erreur et de valeur p.
Ciblage
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Nouvelle valeur d'énumération / erreur Renvoyé lors d'une tentative d'exclusion de toutes les cibles démographiques.
Vidéos
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Nouvelle valeur d'énumération Publication de ZEFR 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é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 majeure 24 de l'API Google Ads.

Pour obtenir des conseils, consultez Passer à la dernière version.

Modifications destructives

État initial Nouvel état Type de modification Instructions relatives à la mise en œuvre
Annonces
videos et logo_images facultatifs dans DemandGenVideoResponsiveAdInfo Champs obligatoires Changement de comportement Indiquez videos et logo_images lorsque vous créez ou modifiez des annonces vidéo Demand Gen responsives.
videos, business_name et logo_images facultatifs dans VideoResponsiveAdInfo Champs obligatoires Changement de comportement Indiquez videos, business_name et logo_images lorsque vous créez ou modifiez des annonces vidéo responsives. Notez que VideoResponsiveAdInfo est désormais modifiable.
Campagnes
Campaign.video_brand_safety_suitability Aucun Suppression Le contrôle de l'adéquation au niveau de la campagne est supprimé. La brand suitability reste disponible au niveau du client. Utilisez Customer.video_brand_safety_suitability à la place.
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 au code.
Planification
Type de InsightsAudienceAttributeGroup pour topic_audience_combinations Type : common.InsightsAudienceAttributeGroup Changement de comportement / 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 Passer à l'utilisation des lineups 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 dispose de 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[].
Abandon des champs de plan / prévision de mots clés dans GenerateKeywordForecastMetrics Aucun Suppression Suppression des champs et types de plan / prévision suivants : Mettez à jour les intégrations en conséquence.
Rapports
ad_sub_network_type segment dans campaign_budget Aucun Suppression Suppression du segment ad_sub_network_type pour la ressource campaign_budget.
click_type Segment 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é.
ShareablePreviewError anciens codes : 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'annonce des groupes d'annonces. Mettre à jour la logique de capture de validation.

Fonctionnalités et mises à jour (non destructives)

Fonctionnalités et mises à jour 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 de la possibilité de récupérer les attributs des composants de 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, view-through conversion) (false par défaut) dans les campagnes Demand Gen et pour applications.
CampaignCriterion.gender Nouvelle fonctionnalité Les exclusions de genre ont été activées pour les campagnes Performance Max dans toutes les versions de l'API Google Ads.
Conversions
Types de conversion pour la génération de prospects Nouvelles valeurs d'énumération Ajout de nouveaux types d'énumérations d'actions 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 d'énumération / erreur Renvoyé lorsque vous tentez de créer plusieurs listes d'audience similaire 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 Expose des rapports segmentant les métriques de conversion par produit spécifique vendu (marque, etc.) en plus du produit cliqué.
Métriques non enchérissables Nouveaux champs Ajout de métriques non enchérissables (métriques indiquant 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 des notes ne sont pas pris en charge.
Filtrage des produits basé sur les tags Nouvelle fonctionnalité Introduction du filtrage dynamique à l'aide d'expressions d'ensemble logiques : Cette fonctionnalité n'est disponible que pour les comptes figurant sur la liste d'autorisation.

Versions majeures et mineures de v23

La version 23 de l'API Google Ads inclut les nouvelles fonctionnalités, mises à jour et modifications destructives suivantes.

v23.3 (24/06/2026)

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

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

Pour vous aider à planifier votre prochain travail d'intégration pour la v25, l'interface permettant de modifier les champs d'attestation de l'annonceur est introduite plus tôt pour la v22 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'effectuer une requête de modification sur l'un de ces champs, l'une des erreurs suivantes sera renvoyée :

"Le champ que vous avez tenté de modifier est immuable" ou "Impossible de définir le champ".

Ces champs deviendront entièrement modifiables à partir de la v25. 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 v25.
Approbations multipartites Nouvelles fonctionnalités Ajout de la compatibilité avec les examens d'approbation multipartite :

v23.2 (25/03/2026)

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

Fonctionnalités et mises à jour Type Description
Éléments
VideoEnhancement Nouvelle ressource Contient des informations sur les annonces vidéo spécifiques à l'amélioration (par exemple, si elles sont 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 fournissant 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 Définissez des contraintes de planification plus précises pour les dates de la campagne. Cette option 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 Demand Gen.
Général
CustomerClientLinkError Nouvelles valeurs d'énumération / erreurs Ajout de deux 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 compatibilité avec les combinaisons ET/OU personnalisées d'entités, de thèmes et d'audiences.
ReachPlanService.GenerateReachForecast Nouvelles valeurs d'énumération 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 d'énumération Ajout de IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS en tant qu'option de surface.
Forecast Nouveau champ Ajout de clicks pour la stratégie "Maximiser les clics" (CPC) de 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 Live en définissant preview_type sur YOUTUBE_LIVE_PREVIEW. Ajout de UNSUPPORTED_AD_TYPE et de TOO_MANY_RESOURCES_IN_REQUEST à ShareablePreviewError. Cette option 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 telles que la v23.1 ne contiennent pas de modifications destructives.

Fonctionnalités et mises à jour Type Description
Gestion du compte
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 s'il 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 d'énumération Ajout de CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED et BOOKING_CANCELLED pour fournir les motifs de l'état principal des campagnes avec 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 une déclaration indiquant si elles contiennent de la publicité à caractère politique ciblant l'UE.
Conversions
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Nouvelle valeur d'énumération 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 d'énumération / erreur Renvoyé lorsque vous essayez de cibler uniquement la catégorie "Inconnu" dans les dimensions démographiques.
Avantages
IncentiveErrorEnum Nouvelles valeurs d'énumération / erreurs Ajout de deux codes d'erreur : MAX_INCENTIVES_REDEEMED et ACCOUNT_TOO_OLD. Ces erreurs peuvent être renvoyées pour les requêtes effectuées à partir du 11 mars 2026.
Planification
GenerateBenchmarksMetrics Nouvelle fonctionnalité Ajout de la compatibilité avec les répartitions par date à l'aide d'un BreakdownDefinition.
ReachPlanService.GenerateReachForecast Nouvelle valeur d'énumération GOOGLE_DISPLAY_NETWORK a été ajouté en tant que surface pouvant être ciblée pour la stratégie "Maximiser les conversions" de Demand Gen.
GenerateTrendingInsights Nouveaux champs Ajout d'informations sur les courbes de tendance historiques 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 d'énumération Ajout de VERTICAL_ADS_DATA_FEED pour prendre en charge les flux de données d'annonces verticales, comme le ciblage d'entités pour les 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 majeure 23 de l'API Google Ads.

Pour obtenir des conseils, consultez Passer à la dernière version.

Modifications destructives

É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 tentant de partager des annonces renverront une erreur AD_SHARING_NOT_ALLOWED.
Prise en charge de CallAd et CallAdInfo Aucun Suppression La compatibilité avec 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 la date 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
Métriques et énumération des libellés de performances des composants agrégés Aucun Suppression Suppression des métriques de libellé de performances des composants agrégés. L'énumération du libellé de performances n'est plus renvoyée pour les campagnes display et sur le Réseau de Recherche.

Fonctionnalités et mises à jour (non destructives)

Fonctionnalités et mises à jour Type Description
Annonces
AdFormatType Nouvelles valeurs d'énumération 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 Champ d'orientation en lecture seule ajouté 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 d'énumération 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 / compatibilité Composants Message à un établissement mis à jour :
Facturation
InvoiceService.ListInvoices Nouvelles options Peut désormais renvoyer 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'énumérations d'assistance pour les frais liés à la réglementation et les unités de mesure.
Campagnes
CampaignError Nouvelles valeurs d'énumération / erreurs Ajout des codes d'erreur DURATION_TOO_LONG_FOR_TOTAL_BUDGET et END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Conversions
ConversionActionCategory Nouvelle valeur d'énumération 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 compatibilité avec les bannières associées dans les annonces vidéo responsives de génération de la demande.
Avantages
Ajout de la compatibilité avec les incitations Choose Your Own (CYO) :

Pour faciliter la gestion programmatique plus précise des échecs, nous ajouterons d'autres codes d'erreur à IncentivesService dans les prochaines versions. Nous vous recommandons de surveiller les annonces et les notes de version à venir concernant ces nouveaux codes d'erreur afin de vous assurer que vos applications peuvent gérer ces nouveaux modes de défaillance.
Planification
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST Nouvelle valeur d'énumération Permet de créer des audiences à l'aide d'é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 / options La réponse inclut désormais des surfaces pour prendre en charge les suggestions de taux de conversion en fonction des commandes de surface (par exemple, Gmail, Shorts). Disponible uniquement pour les campagnes Demand Gen.
LanguageDistribution Nouveau champ / type Ajout de 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 des annonces YouTube aux benchmarks du secteur.
AudienceInsightsService.GenerateAudienceDefinition Nouvelle méthode Traduit une description textuelle 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 sur 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 Désormais compatible avec les métriques d'impression, de performances et de conversion pour RESPONSIVE_DISPLAY_AD.
ad_sub_network_type segment Nouveau segment Fournit une répartition précise 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é Activation de la répartition par type de réseau publicitaire pour les campagnes Performance Max.
UserLocationView
GeographicView		 Compatibilité avec de nouveaux segments Métriques compatibles 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 de l'adresse de l'établissement et de MatchedLocationInterestView (pour les campagnes AI Max) afin de fournir des métriques de performances par emplacement géographique d'intérêt.
Shopping
ShoppingPerformanceView Prise en charge de nouvelles métriques Les métriques suivantes segmentées par date de conversion sont désormais acceptées : 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 de 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 du flux de données relatives aux annonces verticales Nouvelle fonctionnalité Vous pouvez désormais associer un flux de données d'annonces verticales à une campagne sur le Réseau de Recherche utilisant AI Max pour diffuser des annonces de promotion d'établissement et des annonces de voyage avec lien de réservation à côté d'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 segmentés par AdFormatType et dimensions des 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'annonce vidéo.
CampaignCriterionError Nouvelle valeur d'énumération / 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.

Notes de version archivées

Consultez Versions obsolètes pour accéder aux notes de version archivées.