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

Google a publié la version 22 de l'API Google Ads, il s'agit d'une version majeure avec des dizaines de mises à jour. Les mises à jour incluent l'expansion de l'exploration des enchères intelligentes, des améliorations de DemandGen, des campagnes PMax, des campagnes d'applications pour les installations, et bien plus encore.

Google a écrit : « Pour utiliser certaines fonctionnalités de la v22, vous devez mettre à niveau vos bibliothèques clientes et votre code client. Toutes les bibliothèques clientes mises à jour et tous les exemples de code ont été publiés. »

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

Voici les notes de version :

Actifs:

Ajout de LANDING_PAGE_PREVIEW en tant que nouveau type de champ d'élément d'image.

Introduction d'AssetGenerationService (Beta) : ce service permet de générer des ressources texte et image à l'aide de l'IA générative. Ce service est initialement disponible uniquement pour un nombre limité de participants à la bêta fermée. GenerateText : génère du texte en fonction d'entrées telles que l'URL finale, les invites de forme libre, les mots-clés et le contexte de campagne existant. GenerateImages : génère des images en fonction d'entrées telles que l'URL finale, les invites de forme libre, le contexte de campagne existant ou en recontextualisant les images de produits existantes. Les erreurs lors de la génération d'actifs sont renvoyées avec les codes de AssetGenerationErrorEnum.

Campagnes :

Ajout de nouveaux objectifs d'enchères pour les campagnes d'applications pour les installations (ACi) afin d'optimiser sans spécifier de cible, ce qui est utile pour une mise à l'échelle rapide ou lorsqu'il est difficile de déterminer la bonne cible. Dans AppCampaignBiddingStrategyGoalType :

Ajout de la prise en charge de la part fixe du type de stratégie d'enchères vocales.

Ajout de Campaign.feed_types, affichant les types de flux attachés à une campagne. Pour les campagnes Performance Max, cela peut indiquer le secteur d'activité, tel que MERCHANT_CENTER_FEED pour le commerce de détail.

Autorisé à associer des ensembles partagés NEGATIVE_KEYWORDS à MULTI_CHANNEL (pour les campagnes pour applications) et aux campagnes LOCAL.

Génération de demande :

Ajout de la stratégie d'enchères TargetCPC pour les campagnes Demand Gen. Cette stratégie définit les enchères pour maximiser les clics au coût par clic (CPC) cible configuré.

Ajout d'un nouveau AssetAutomationType : GENERATE_DESIGN_VERSIONS_FOR_IMAGES : disponible pour DemandGenMultiAssetAds. Si cette option est activée, cela ajoute des éléments de conception et intègre des éléments de texte dans des éléments d'image pour créer de nouveaux éléments d'image avec des proportions différentes. Les nouvelles DemandGenMultiAssetAds sont activées par défaut.

Ajout d'un nouveau AssetAutomationType : GENERATE_VIDEOS_FROM_OTHER_ASSETS : disponible pour DemandGenMultiAssetAds. S'il est activé, il génère des vidéos en utilisant d'autres ressources telles que des images et du texte. Ces vidéos peuvent ensuite être utilisées pour créer de nouvelles DemandGenVideoResponsiveAds. Les nouvelles DemandGenMultiAssetAds sont activées par défaut.

Renommé le champ BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros en minimum_budget_amount_micros.

Général:

Ajout d'une limite de 10 000 opérations par requête AddBatchJobOperations.

Gestion mise à jour du champ page_size dans ListBatchJobResultsRequest : si page_size n'est pas défini ou est égal à 0, sa valeur par défaut est désormais la valeur maximale de 1 000 (précédemment renvoyé INVALID_PAGE_SIZE). Si page_size dépasse 1 000, l’API renvoie désormais une erreur INVALID_PAGE_SIZE (auparavant plafonnée silencieusement à 1 000).

Ajout d'un nouveau code d'erreur : QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED pour indiquer lorsque la limite des taux d'activation du profil de paiement a été dépassée.

Performances maximales :

Ajout de nouvelles valeurs AssetAutomationType pour les campagnes Performance Max : GENERATE_IMAGE_ENHANCEMENT : permet la création automatique d'images améliorées telles que le recadrage automatique. Activé par défaut. GENERATE_IMAGE_EXTRACTION : permet de rechercher automatiquement des images à partir des URL finales. La valeur par défaut est le paramètre d'extension d'image dynamique au niveau du compte.

AssetPerformanceLabel a été supprimé pour les campagnes Performance Max.

La fonctionnalité du Campaign.url_expansion_opt_out supprimé est désormais gérée en définissant AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION dans AssetAutomationSetting.

Ajout de nouveaux segments pour les campagnes Performance Max. Chacun de ces segments n'est disponible que pour les campagnes Performance Max et ne renvoie aucune donnée lorsqu'un autre type de campagne est sélectionné. ad_using_product_data : indique si une annonce utilise les données produit d'un flux Google Merchant Center. ad_using_video : indique si une annonce utilise un élément vidéo.

Planification:

Dans UserListCrmDataSourceType, ajout de la valeur THIRD_PARTY_PARTNER_DATA.

Ajout de nouveaux codes d'erreur liés aux audiences partenaires :

Ajout de is_active_live_stream_creator à YouTubeMetrics. Ceci est renvoyé par ContentCreatorInsightsService.GenerateCreatorInsights et indique si un créateur a publié une diffusion en direct au cours des 90 derniers jours.

Ajout d'un nouveau message PlannableUserListMetadata qui contient UserListCrmDataSourceType dans PlannableUserList. Ce message est renvoyé par « ReachPlanService.ListPlannableUserLists » pour indiquer si une source de données de liste d'utilisateurs CRM est FIRST_PARTY ou THIRD_PARTY_PARTNER_DATA.

Dans ReachPlanService, ajout du champ trueview_views, qui remplace le champ vues.

Dans TrendInsight, ajout de la prise en charge de Related_videos et Related_creators. Ajout également des métadonnées des propriétés vidéo et des dates de publication dans YouTubeVideoAttributeMetadata.video_properties et YouTubeVideoAttributeMetadata.publish_date.

AudienceInsightsService.GenerateInsightsFinderReport prend désormais en charge parental_status et revenue_ranges, ainsi que des combinaisons ET/OU plus complexes de sujets et d'audiences.

Rapports :

Ajout de deux nouveaux types de clics : CLICK_TO_MESSAGE_THIRD_PARTY_CLICK et CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.

AssetGroupAsset est désormais segmentable par appareil, conversion_action, conversion_action_name et conversion_action_category.

AdGroupAdAssetView et AdGroupAdAssetCombinationView prennent désormais entièrement en charge les statistiques de performances et de conversion pour RESPONSIVE_SEARCH_AD. Auparavant, seules les impressions étaient renvoyées pour ce type d'annonce dans ces vues.

Pour faciliter l'exploration des enchères intelligentes, les statistiques suivantes sont désormais segmentables par champs de date (date, mois, trimestre, semaine, année) : clicks_unique_query_clusters, conversions_unique_query_clusters, impressions_unique_query_clusters.

Ajout d'une nouvelle ressource : TargetingExpansionView, qui rapporte des métriques pour les expansions par rapport au ciblage manuel, telles que l'expansion sans mot clé pour AI Max pour les campagnes de recherche.

Ajout de nouveaux segments pour les campagnes PMax. Consultez les mises à jour de Performance Max.

Achats:

Correction de la portée des métriques de la campagne et du groupe d'annonces dans la ressource ShoppingProduct.

Objectifs unifiés :

Ajout de la prise en charge des objectifs de fidélisation des clients afin d'optimiser le réengagement des clients existants.

Configurez le ciblage à l'aide de CampaignRetentionGoalSettings.target_option : TARGET_SPECIFIC : utilise uniquement les utilisateurs des listes d'utilisateurs associées à la campagne. (Actuellement, liste verte uniquement). TARGET_ALL (par défaut) : cible tous les utilisateurs pour le réengagement.

Discussion sur le forum X.