Google Ads API version 21 maintenant disponible

Google a publié la version 21 de l'API Google ADS, il s'agit d'une version majeure avec des dizaines de mises à jour. Les mises à jour incluent AI Max pour les campagnes de recherche, les modifications PMAX, les mises à jour de rapport et bien plus encore. Google a également fait des mises à jour de la documentation de son API Google ADS Aidez les documents.

Avant cette version, la version 20 le 5 juin 2025, 19.1 en avril 2025, puis 19 en février 2025, puis la version 18 en octobre 2024. Avant, il était 17.1 en août 2024, puis avant cela, la version 17.0 en juin 2024, puis avant cela, la version 16.1 puis avant la version 16 qui était publiée en août. La version 13.1 a précédé cette nouvelle version, publiée en avril 2023. La version 12.0 a été publiée en octobre 2022, la version 11.0 de l'API Google Ads a été publiée en juin et la version 11.1 était en août. La version 10.1 a également été publiée le 27 avril 2022 et la version 10.0 a été publiée le 9 février 2022. Et Google a Sunset the AdWords API le 27 avril qui cessera complètement de travailler fin juillet.

Voici un résumé vidéo de ces changements:

https://www.youtube.com/watch?v=G2OOEU0SYJM

Voici le journal de changement complet:

AI Max pour les campagnes de recherche:

• Vous pouvez maintenant utiliser le champ AI_MAX_Setting.enable_ai_max de la campagne pour activer AI Max pour les campagnes de recherche. AI Max pour les campagnes de recherche étend la portée d'une campagne de recherche grâce à la correspondance du terme de recherche et permet de contrôler si le ciblage et les contrôles créatifs servent lorsqu'ils sont définis. Les commandes d'automatisation des actifs en texte et de liste de marques qui ont été définies dans les demandes de version précédente seront toujours respectées jusqu'à ce que AI Max pour les campagnes de recherche soit explicitement basculé et désactivé. Campaign.ai_max_setting.bundling_reQuired peut être utilisé pour déterminer si AI Max pour les campagnes de recherche doit être activé pour respecter ou modifier l'automatisation des actifs du texte et les contrôles de liste de marque. Adgroup.ai_max_ad_group_setting.disable_search_term_matching peut être utilisé pour désactiver la correspondance des termes de recherche lorsqu'une campagne parent a activé AI Max pour les campagnes de recherche. Voir notre article de blog Déverrouiller les performances de niveau supérieur avec AI Max pour les campagnes de recherche.
• Ajout de CampaignError.ai_Max_Must_Be_enabled, qui est lancé pour des campagnes de recherche lorsque vous optez pour final_url_expansion_text_asset_automation sans activer AI Max pour les campagnes de recherche sur la campagne.
• Ajout de la prise en charge de l'application de contrôles de ciblage au niveau du groupe d'annonces dans AI Max pour les campagnes de recherche. Vous pouvez désormais ajouter les critères suivants aux groupes d'annonces: listes de marques, emplacements et pages Web (règles d'URL)
• Ajout de l'AI_MAX_SEARCH_TERM_AD_COMBINAT_VIEVE pour rendre compte des performances des combinaisons de termes de recherche, de titres et de pages de destination. Cette vue montre quelles requêtes de recherche ont déclenché vos annonces et comment ces combinaisons spécifiques ont été effectuées. Une version future comprendra une vue supplémentaire qui comprend également des données maximales de performances. Si vous souhaitez éviter de migrer votre implémentation pour obtenir des données de performances maximales, envisagez d'attendre cette version.
• Ajout de AI_MAX en tant que nouvelle valeur pour le segment Search_term_match_type.

Actifs:

• Ajout des champs termes_and_conditions_text, termes_and_conditions_uri, promotion_barcode_info et promotion_qr_code_info dans promotionAsset. Les champs de code à barres et de code QR sont situés dans le Promotion_Trigger OneOf.
• Ajout de final_url_expansion_text_asset_automation à AssetAutomationTypeenum. Avec ce paramètre, vous pouvez contrôler la génération automatique d'actifs de texte et de pages de destination à partir de l'URL finale des campagnes de recherche.
• Ajout d'un nouveau service AutoCreatedAssetRemoValService.removecampaignAutomAticAmAmatyCreatEdAsset pour supprimer les actifs créés automatiquement de la campagne. Ce service prend en charge la suppression de l'actif d'expansion de l'URL final uniquement.
• Ajout de description_prefix à l'énumération desservieSetFieldType. Cela corrige un problème où le servi_asset_field_type dans ad_group_ad_asset_combination_view était inconnu pour les actifs servant de préfixe de description.

Campagnes:

• Ajout d'une nouvelle valeur d'énumération manquante_location_targeting à CampaignPrimaryStatusReason. Cette nouvelle raison d'état ne sera retournée que pour les campagnes restreintes de localisation qui ne spécifient pas le ciblage de l'emplacement. Pour les campagnes restreintes de localisation, toute tentative d'ajouter le ciblage de l'emplacement en dehors de la zone autorisée entraînera l'erreur de critère location_targeting_not_elible_for_restritt_campaign.
• Ajout de la prise en charge des partenaires d'intégration tiers sur le VideoCustomer.third_party_integration_partners et des niveaux de campagne.third_party_integration_partners. Consultez les conversions d'applications d'article du centre d'aide avec l'analyse des applications tierces.
• Vous pouvez désormais définir le champ Advertising_Partner_IDS pour une campagne existante. Auparavant, ce champ ne pouvait être défini que pour une nouvelle campagne lors de sa création.
• En utilisant une liste partagée de type type_placement_list défini au niveau du compte Manager, les annonceurs peuvent désormais utiliser les critères CustomEnGativECriterion pour exclure une liste de placements dans les comptes clients de l'annonceur individuel.
• Ajout de description_prefix à l'énumération desservieSetFieldType. Cela corrige un problème où le servi_asset_field_type dans l'AD_Group_ad_asset_combination_view était inconnu pour les actifs servant de préfixe de description.
• Ajout de la prise en charge du champ Target_roas_toleance_percent_millis dans les stratégies de soumission MaximizEConversionValue et Targetroas. Targetroas.target_roas_toleance_percent_millis n'est disponible que pour les stratégies de portefeuille, qui n'est disponible que pour les campagnes de recherche.
• Modifié un code d'erreur de produit produit. Pour les demandes avec une défaillance partielle activée, listing_group_error_in_another_opération sera renvoyée au lieu de invalid_listing_group_hierarchy.
• Ajout d'une nouvelle localisation de ressources Intestrestview qui résume les performances des critères d'intérêt de localisation ADGROUP.

Conversions:

• Ajout de l'engaged_view comme nouvelle valeur pour le segment Conversion_Attribution_event_type.
• Les clients n'auront plus accès au mode debug_enabled dans ConversionUploadService. Ce champ, s'il est défini sur true, a été utilisé plus tôt pour distinguer l'erreur clic_not_found du succès pour les conversions améliorées pour les importations de leads.

Demande Gen:

• Ajout d'un code d'erreur CampaignBudgeTerror.Budget_Below_Daily_Minimum. À l'avenir, cette erreur sera retournée lors de la tentative de fixer un montant à très petit budget pour une campagne de génération de demande. Des détails sur le budget minimum requis peuvent être trouvés dans les nouveaux détails d'erreur BudgetDailDailDiMiMumerRorDeTails.

Changements de publicité politique de l'UE:

Ces changements de publicité politique de l'UE ont également été apportés aux versions des versions V19.2 et V20.1.

• Ajout de la campagne.conts_eu_political_advertising. Ce domaine indique si votre campagne contient du contenu de publicité politique destinée à l'Union européenne. Si ce champ est défini sur contenu_eu_political_advertising, la campagne ne servira plus dans l'UE à partir du 22 septembre 2025. Les appels API pour créer une nouvelle campagne échoueront avec un champ de champ de champière. Erreur réquise si ce champ n'est pas défini. Pour toutes les campagnes existantes, vous devez définir le champ CONTAINS_EU_POLICATIQUE_ADVERTISTINE avant de tenter de modifier la proximité, l'emplacement ou le groupe de localisation ciblant les niveaux de campagne ou de groupe d'annonces. L'API appelle pour créer ou mettre à jour ces critères de campagne ou de groupe d'annonces pour les campagnes existantes échoueront avec une erreur de critèreerror.missing_eu_political_advertise_self_decloration si la campagne n'a pas terminé l'auto-déclaration. Pour les versions v19.x et 20.x, l'exigence de définir ce champ n'est pas encore appliquée, mais sera à l'avenir. Ce changement sera annoncé à l'avance.
• Les essais et les expériences lanceront un expérimentor.Missing_eu_political_advertising_self_declartation si les campagnes de l'expérience n'ont pas autodéfini, qu'ils contiennent de la publicité politique qui cible l'Union européenne.

Performance Max:

• Pour les nouvelles campagnes PMAX, la valeur par défaut de la campagne.brand_guidelines_enabled est désormais vraie.
• Ajout du rapport Campaign_Search_term_view. Cette vue offre des termes de recherche de mesures agrégées au niveau de la campagne. Cette vue présente également la prise en charge de la campagne Performance Max pour les termes de recherche.
• Ajout de performances_max comme nouvelle valeur pour le segment Search_term_match_type.

Planification:

• Ajout d'une nouvelle méthode ReachPlanService.ListPlannableUser Interests, qui permet aux annonceurs de découvrir les intérêts des utilisateurs (affinités et marchés sur les marchés) pris en charge par ReachPlanService.GeneraterEachForCast. La méthode prend en charge la recherche de types d'intérêt pour les utilisateurs spécifiques et de requête pour les noms et les chemins.
• Ajout d'une application supplémentaireInfo à ReachPlanService.ListPlannableUserlists comme champ de saisie en option.
• Ajout d'un support à AudivacreInsightsService.ListAdienceInsightSattributes pour récupérer les listes d'utilisateurs 1P disponibles pour la demande d'identification du client.
• Ajout de l'utilisateur 1P répertorie la prise en charge de l'auditoireInsightsService.GenerateAUDICECompositionInsights pour récupérer des informations pour le public ciblant une liste d'utilisateurs. Toute demande qui cible une liste d'utilisateurs ne renvoie que l'index d'audience et n'est disponible que pour le public InsightsDimension: Age_Range, Gender, Affinity_User_INTEREST, IN_MARKET_USER_INTEREST.
• Mise à jour du type d'entrée d'audience sur InsightsAudice pour AudienceInsightsService.GenerateTargetingingSuggeSionMetrics. La nouvelle entrée d'audience permet une combinaison d'intérêts d'utilisateurs et d'or ou de la prise en charge des mesures potentielles à portée de potentiel pour des définitions d'audience plus personnalisées.
• Ajout de la part d'audience à TrendInSightMetrics pour obtenir la part d'un public pour une tendance.
• Ajout de nouvelles catégories connexes à KnowledgeGraphAttributeMetAdata afin que les utilisateurs puissent filtrer les attributs de graphiques de connaissances par catégorie.

Rapports:

• Une variété de nouvelles métriques sont désormais disponibles pour AssetGroupAsset, ChannelAggregateSsetView et CampaignAggregateAsSetView. De plus, pour ChannelAggregateAsSetView et CampaignAggregateSsetView, Impressions, qui était auparavant à zéro pour les campagnes Performance Max, rapportera désormais sa véritable valeur.
• Rendu la ressource AssetSet sélectionnable avec ChangeStatus afin que les utilisateurs puissent obtenir plus d'informations sur la ressource de type AssetSet ou CampaignAssetSetSet dans une requête.
• Rendu la ressource CampaignAssetSetSet sélectionnable avec ChangeStatus afin que les utilisateurs puissent obtenir plus d'informations sur la ressource de type AssetSet ou CampaignAssetSetSet dans une requête.
• Ajout d'un nouveau segment Search_term_targeting_status qui peut être sélectionné dans la vue du terme de recherche de campagne.
• Ajout d'un nouveau final_url_expansion_asset_view.
• Ajout de la prise en charge de Metrics Value_Adjustment et All_Value_Adjustment dans le rapport AssetGroup.
• Rendu AssetGroupAsset segmentable par ad_network_type.
• Ajout d'un nouveau segment LANDING_PAGE_SOURCE qui peut être utilisé avec la ressource Landing_Page_View.
• Ajout d'un nouveau segment Search_term_match_source qui peut être sélectionné dans le terme de recherche et les vues de terme de recherche de campagne.
• Ajout d'un nouveau segment match_type qui peut être sélectionné dans la vue du mot-clé.
• Ajout de la prise en charge des mesures pour les grappes d'intention de requête uniques avec
• Ajout d'un nouveau clic type véhicule_assets dans la segmentation click_view pour suivre et signaler les clics liés aux formats d'annonces spécifiques aux actifs du véhicule.

Vidéo:

• Ajout de YouTubevideolistAsset. Ajout de l'actif # youtube_video_list_asset, qui peut être utilisé pour créer un lien entre une campagne et un type YouTubevideolistAsset. Voir l'article du centre d'aide Utiliser des vidéos connexes.
• Ajout de nouveaux champs de métadonnées à YouTubeChannelInsights et YouTubevideoatTrributeMetadata.
• De nouveaux types de clics exposés: video_related_videos_click, vidéo_channel_click et product_assets.
• Ajout du champ Allow_Non_Skippable_in_Stream à VideoAdInventoryControl pour permettre aux annonces de réacturation vidéo servir de publicités dans la circulation non skippables. Cette option est disponible pour les campagnes qui prennent en charge le mélange du format non skippable avec d'autres formats.
• Ajout de la campagne.videoCampaignSettings.video_ad_Sequence et adgroup.videoAdGroupSettings.videoAdSenenceSpsetting Fields (Read only). Consultez l'article du Centre d'aide sur le séquençage de l'annonce vidéo.
• Ajout de nouveaux champs de métadonnées à YouTubeChannelInsights et YouTubevideoatTrributeMetadata.
• Ajout du type de critère Video_lineup et du champ Video_lineup à CampaignCriterion et AdGroupCriterion. Cette fonctionnalité est disponible pour autoriser uniquement les comptes. Contactez votre représentant de Google Business Development pour plus de détails.
• Ajout d'un rapport d'adéquation du contenu pour le détail et le niveau de groupe. Consultez l'article du Centre d'aide sur le rapport «Contenu Amélioration du contenu».