L'API Google Ads version 23.1 est désormais disponible

Google a publié une mise à jour mineure de l'API Google Ads, version 23.1. Cette mise à jour apporte des modifications à la gestion des comptes, aux campagnes, aux conversions, aux incitations, à la planification, aux rapports et bien plus encore.

Google a écrit : « Pour utiliser les nouvelles fonctionnalités v23.1, vous devez mettre à niveau vos bibliothèques clientes et votre code client. Toutes les bibliothèques clientes mises à jour et les exemples de code ont été publiés. Nous publions également des versions mineures v20.2, v21.1 et v22.1 de l'API Google Ads pour ajouter une prise en charge supplémentaire du règlement européen sur les publicités politiques.

Avant cette version, c'était la version 23 fin janvier, puis la version 22 le 15 octobre 2025, puis la version 21 le 6 août 2025, puis la 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 17.1 en août 2024 et puis avant cela, il y avait la version 17.0 en juin 2024, puis avant cela, il y avait la version 16.1, puis la version 16 en février 2024. Avant cela, il y avait la version 15 en octobre 2023. Puis 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 :

Gestion des comptes

Ajout de Advertising_partner_properties.allowed_domain aux ressources ProductLinkInvitation et ProductLink. Le partenaire publicitaire ne pourra faire de la publicité que sur ce domaine.

Ajout du champ contain_eu_politique_advertising à la ressource Client. Ce champ récupère le statut de la déclaration au niveau du compte, indiquant s'il contient de la publicité politique destinée à l'UE, et renvoie un EuPoliticalAdvertisingStatusEnum.

Campagnes

Ajout de la prise en charge des consignes de texte, qui peuvent être utilisées avec les campagnes Performance Max et sur le Réseau de Recherche pour contrôler par programmation les éléments textuels générés par l'IA.

Ajout du champ Campaign.text_guidelines à la ressource Campaign.

Dans text_guidelines, vous pouvez définir term_exclusions et messagerie_restrictions.

Ajout de CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED et CampaignPrimaryStatusReason.BOOKING_CANCELLED pour fournir les raisons principales du statut des campagnes avec la stratégie d'enchères FIXED_CPM.

Ajout de Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure et Campaign.VideoCampaignSettings.booking_details (lecture seule).

Ajout de Campaign.missing_eu_politique_advertising_declaration pour prendre en charge l'interrogation et le filtrage des campagnes pour lesquelles il manque des déclarations indiquant si elles contiennent de la publicité politique ciblant l'UE.

Conversions

Ajout de ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS pour prendre en charge le suivi des utilisateurs qui regardent une publicité et regardent plus tard une vidéo sur la même chaîne.

Général

Ajout de CANNOT_TARGET_ONLY_UNDETERMINED à CriterionErrorEnum. Cette erreur est renvoyée lorsque vous tentez de cibler uniquement la catégorie indéterminée dans les dimensions démographiques.

Incitations

Ajout de deux nouveaux codes d'erreur à IncentiveErrorEnum : MAX_INCENTIVES_REDEEMED et ACCOUNT_TOO_OLD. Ces erreurs peuvent être renvoyées pour les demandes effectuées à compter du 11 mars 2026.

Planification

Ajout de la prise en charge des répartitions de dates dans GenerateBenchmarksMetrics à l'aide d'un BreakdownDefinition.

Ajout de GOOGLE_DISPLAY_NETWORK en tant que surface ciblable pour les conversions Demand Gen Max dans ReachPlanService.GenerateReachForecast.

Ajout d'informations sur la ligne de tendance historique dans TrendInsightDataPoint à TrendInsights dans GenerateTrendingInsights lors d'une recherche par sujet.

Rapports

Ajout de nouvelles statistiques indiquant combien d'utilisateurs ont vu votre annonce au moins deux, trois, quatre, cinq ou dix fois : unique_users_two_plus, unique_users_trois_plus, unique_users_four_plus, unique_users_five_plus et unique_users_ten_plus.

Ajout de VERTICAL_ADS_DATA_FEED à SearchTermMatchSourceEnum pour prendre en charge les flux de données publicitaires verticaux (par exemple, le ciblage d'entités Travel Ads).

YouTubeVidéoTélécharger

Ajout du service YouTubeVideoUpload pour prendre en charge le téléchargement et la gestion de vidéos sur YouTube, ainsi que de la ressource YouTubeVideoUpload pour prendre en charge la récupération de l'état de téléchargement et des métadonnées. Cette fonctionnalité est uniquement prise en charge pour REST et la bibliothèque client Python.

Discussion sur le forum X.