Cette page a été traduite par l'API Cloud Translation.

Notes de version

Cette page fournit des notes de version pour l'API AdSense Management.

Version 2

Cette version introduit les modifications suivantes afin de supprimer les fonctionnalités obsolètes et d'aligner l'API AdSense Management sur les normes actuelles des API Google. Conformément au schéma de gestion des versions des API Google, cette version sera mise à jour au fil du temps pour inclure des fonctionnalités supplémentaires (rétrocompatibles), plutôt que de nouvelles fonctionnalités publiées dans des versions mineures distinctes.

2025-10-02

Rapports

Ajout de la dimension TRAFFIC_SOURCE, qui permet de décomposer les métriques par source de trafic (par exemple, "Google", "Bing", "Facebook" ou "Autre"). Pour en savoir plus, consultez Répartition des sources de trafic.

2025-05-06

PolicyIssues

Le champ policyTopics[].must_fix obsolète (voir la mise à jour précédente) sera désormais toujours défini sur false.

2025-02-24

PolicyIssues

Ajout d'un champ policyTopics[].type pour identifier si un thème de règlement représente un problème concernant les règles, un problème réglementaire ou une préférence d'annonceur. Cela remplace policyTopics[].must_fix, qui est désormais marqué comme champ obsolète.

2024-04-03

PolicyIssues

Ajout d'une collection permettant de générer des rapports sur les avertissements et les cas de non-respect des règles actuels pour un compte.

2023-06-19

Paiements

payments.list renvoie désormais des informations sur les paiements pour les éditeurs Premium.

2023-06-13

Rapports

Ajout des métriques FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS et FUNNEL_RPM, qui fournissent des informations sur les performances des blocs non publicitaires (par exemple, les blocs de recherche associée).

2023-03-30

Rapports

Ajout de la dimension PAGE_URL, qui permet de répartir les métriques par URL de page (avec quelques mises en garde, voir Répartition par URL de page).

2022-09-21

AdUnits

Ajout des méthodes de création et de correction. Notez que ces méthodes ne peuvent être utilisées que par les projets activés pour le produit AdSense pour les plates-formes.

CustomChannels

Ajout des méthodes de création, de correction et de mise à jour. Notez que ces méthodes ne peuvent être utilisées que par les projets activés pour le produit AdSense pour les plates-formes.
Ajout du champ "active" à la ressource.

Comptes

Ajout de la méthode getAdBlockingRecoveryTag.

2022-08-25

Rapports

Ajout de la dimension HOSTED_AD_CLIENT_ID, qui permet aux éditeurs hôtes et de plates-formes de répartir les métriques par compte d'éditeur (éditeurs hôtes) et par sous-compte (éditeurs de plates-formes).

2022-05-03

AdClient

Ajout de la méthode get.

Rapports

Ajout de la méthode getSaved.

UrlChannels

Ajout de la méthode get.

2022-03-31

Compte

Les comptes inactifs sont désormais renvoyés par l'API, avec un champ state indiquant l'état du compte.

AdClient

Comme pour les modifications apportées aux comptes, les clients publicitaires inactifs sont désormais renvoyés par l'API, avec un champ state indiquant l'état du client publicitaire.

2022-02-24

Paiement

Le format du nom de ressource a été étendu pour prendre en charge des ressources distinctes pour les revenus YouTube. Ce changement intervient avant le déploiement progressif de la nouvelle expérience AdSense pour les créateurs YouTube, dans laquelle les revenus YouTube seront séparés dans leur propre compte de paiement. Les informations de paiement YouTube seront également renvoyées par la méthode de liste des paiements une fois que vous aurez un compte de paiement dédié aux revenus YouTube. Les revenus YouTube auront le format de nom de ressource suivant :
- accounts/{account}/payments/youtube-unpaid pour les revenus YouTube impayés (actuels).
- accounts/{account}/payments/youtube-yyyy-MM-dd pour les revenus YouTube payants.
Remarque : Les noms de ressources pour les revenus AdSense restent inchangés :
- accounts/{account}/payments/unpaid pour les revenus AdSense (actuels) impayés.
- accounts/{account}/payments/yyyy-MM-dd pour les revenus AdSense payés.

2021-06-30

Signaler

Ajout des dimensions AD_FORMAT_NAME et AD_FORMAT_CODE, qui indiquent la façon dont une annonce est diffusée auprès des utilisateurs sur votre site (sur la page, vignette, etc.). Notez que la version 1.4 comportait des dimensions (obsolètes) portant les mêmes noms, mais avec des membres différents. Les deux dimensions ajoutées dans la version 2 sont distinctes de celles présentes dans la version 1.4.

2021-04-19 (Version initiale)

Général

Toutes les méthodes obsolètes de la version 1.4 ont été supprimées. Cela inclut les méthodes de ressources qui ne nécessitaient pas de accountId. Dans la version 2, le accountId est spécifié dans le champ parent.
Conformément aux normes des API Google, les ressources sont désormais identifiées par un champ name. Par exemple, le nom d'un AdClient se présente comme suit : accounts/{accountId}/adclients/{adClientId}. De plus, dans la version 1.4, l'ID de ressource était utilisé comme dimension de reporting, mais dans la version 2, cette valeur est désormais disponible via un champ reporting_dimension_id sur plusieurs ressources.
Le champ kind a été supprimé de toutes les ressources.

Compte

Le champ name a été remplacé par display_name.
Le champ timezone est passé d'une chaîne à un google.type.TimeZone.
Le champ creation_time (type int64) a été remplacé par create_time (type google.protobuf.Timestamp).
Ajout d'un champ pending_tasks qui est une liste des tâches en attente à effectuer lors de la procédure d'inscription pour un nouveau compte. Par exemple, les tâches peuvent être liées à votre profil de facturation ou à la validation de votre numéro de téléphone.
Le champ sub_accounts a été supprimé. Une fonctionnalité similaire peut être obtenue dans la version 2 avec la méthode personnalisée listChildAccounts. L'arborescence complète du compte enfant peut être générée dans la version 2 en appelant listChildAccounts de manière récursive.

AdClient

Le champ arc_opt_in a été supprimé, car il l'a déjà été de l'UI AdSense.
Le champ supports_reporting est remplacé par le champ reporting_dimension_id, qui représente l'ID unique du client publicitaire tel qu'il est utilisé dans la dimension de reporting AD_CLIENT_ID. Si reporting_dimension_id est vide, cela signifie que AdClient n'est pas compatible avec les rapports.

AdUnit

Le champ status a été renommé state. De plus, l'état ACTIVE n'indique plus s'il y a eu de l'activité sur ce bloc d'annonces au cours des sept derniers jours. Dans la version 2, cela signifie que le bloc d'annonces a été activé par l'utilisateur et qu'il peut diffuser des annonces.
Le champ code a été supprimé. Cette valeur se trouve toujours à la fin du champ name (après la dernière barre oblique).
Le champ contentAdsSettings.backupOption a été supprimé.
Le champ type est désormais limité aux valeurs TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT et LINK.
D'autres champs qui ont déjà été supprimés de l'interface utilisateur AdSense sont également supprimés : custom_style, saved_style_id, mobile_content_ads_settings et feed_ads_settings.

Alerte

La méthode delete a été supprimée.
Le champ is_dismissible a été supprimé.
Le champ locale a été renommé language_code.

CustomChannel

Le champ code a été supprimé. Cette valeur se trouve toujours à la fin du champ name (après la dernière barre oblique).
Le champ targeting_info a été supprimé, car il l'a déjà été de l'UI AdSense.

Paiement

Le champ payment_date a été renommé date et son type est passé de chaîne à google.type.Date.
Les champs payment_amount et payment_amount_currency_code ont été combinés en un seul champ payment (par exemple, "¥1,235 JPY", "$1,234.57", "£87.65").

Signaler

Avec la version 2, les données de reporting de l'API AdSense Management sont désormais alignées sur l'interface utilisateur AdSense. Cela signifie que les propriétés AdMob et YouTube ne sont plus prises en charge. De plus, l'API ne prendra en charge que les données de rapport remontant à trois ans.
Les ressources Metadata.dimensions et Metadata.metrics ont été supprimées.
De nouvelles méthodes ont été ajoutées pour générer une version CSV du rapport, en remplacement des paramètres de requête de la version 1.4. Remarque : Pour la compression, vous pouvez toujours utiliser l'en-tête HTTP "Accept-Encoding: gzip".
Certains champs ont été modifiés lors de la génération de rapports ad hoc.
- Le champ account_id a été renommé account.
- Le champ dimension a été renommé dimensions.
- Le champ metric a été renommé metrics.
- Le champ filter a été renommé filters.
- Le champ sort a été renommé order_by.
- Le champ locale a été renommé language_code.
- Le champ currency a été renommé currency_code.
- Vous pouvez désormais spécifier plusieurs plages courantes avec date_range (par exemple, TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS et LAST_30_DAYS), ou vous pouvez spécifier un start_date et un end_date en définissant date_range sur CUSTOM.
- Les champs start_date et end_date sont passés du type chaîne au type google.type.Date. Remarque : Par conséquent, les mots clés de date relative (par exemple, "today-6d") ne sont plus acceptées.
- Le champ booléen use_timezone_reporting a été remplacé par reporting_time_zone, qui peut avoir l'une des deux valeurs suivantes : ACCOUNT_TIME_ZONE ou GOOGLE_TIME_ZONE (ce qui signifie PST/PDT). La valeur par défaut dans la version 2 est ACCOUNT_TIME_ZONE, ce qui diffère de la valeur par défaut dans la version 1.4.
- Le champ start_index a été supprimé.
- Le champ max_results a été renommé limit.
Certains champs ont été modifiés dans la génération des rapports enregistrés.
- Ajout de champs de date (date_range, start_date, end_date, reporting_time_zone).
- Ajout d'un champ currency_code.
- Le champ locale a été renommé language_code.
- Le champ start_index a été supprimé.
- Le champ max_results a été supprimé.

SavedAdStyle

SavedAdStyle a été supprimé, car il l'a déjà été de l'UI AdSense.

Site

Sites ont été ajoutées pour récupérer des données sur les sites Web que vous avez ajoutés à votre compte AdSense.
Le champ state indique si le site se trouve dans l'un des états suivants : REQUIRES_REVIEW, GETTING_READY, READY ou NEEDS_ATTENTION.
Le champ auto_ads_enabled est un booléen qui indique si les annonces automatiques ont été activées sur un site donné.