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 de l'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.

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 présents dans un compte.

2023-06-19

Paiements

La méthode payments.list affiche désormais les détails des 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-annonces (par exemple, les blocs de recherche associée).

2023-03-30

Rapports

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

2022-09-21

AdUnits

Ajout de méthodes create et patch. 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 de méthodes de création, de correctif 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 actif à 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 plate-forme de répartir les métriques par compte d'éditeur (éditeurs hôtes) et par sous-comptes (éditeurs de plate-forme).

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

L'API renvoie désormais les comptes inactifs, avec un champ state indiquant l'état du compte.

AdClient

Comme pour les modifications de compte ci-dessus, 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 permettre l'utilisation de ressources distinctes pour les revenus YouTube. Ce changement est antérieur au déploiement progressif de l'expérience AdSense améliorée pour les créateurs YouTube, dans laquelle les revenus YouTube seront séparés dans un compte de paiement dédié. Dès lors que vous disposez d'un compte de paiement dédié aux revenus YouTube, les informations de paiement YouTube sont également renvoyées à partir de la méthode de la liste de paiements. Le nom de ressource utilisé pour les revenus YouTube est le suivant :
- accounts/{account}/payments/youtube-unpaid pour les revenus YouTube impayés (actuels).
- accounts/{account}/payments/youtube-yyyy-MM-dd pour les revenus YouTube payés.
Remarque:Les noms des ressources pour les revenus AdSense restent inchangés :
- accounts/{account}/payments/unpaid pour les revenus AdSense impayés (actuels).
- accounts/{account}/payments/yyyy-MM-dd pour les revenus AdSense payés.

2021-06-30

Rapport

Les dimensions AD_FORMAT_NAME et AD_FORMAT_CODE ont été ajoutées pour indiquer la façon dont une annonce est présentée aux utilisateurs sur votre site (encart, vignette, etc.). Notez que la version 1.4 comportait (obsolète) des dimensions portant les mêmes noms, mais dont les membres étaient différents. Les deux dimensions ajoutées dans la version 2 sont différentes de celles présentes dans la version 1.4.

19/04/2021 (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 n'avaient pas besoin d'un accountId. Dans la version 2, accountId est spécifié dans le champ parent.
Conformément aux normes d'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 rapport, 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 à 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 dans le cadre du processus d'inscription à un nouveau compte. Par exemple, les tâches peuvent être liées à votre profil de facturation ou à la validation du numéro de téléphone.
Le champ sub_accounts a été supprimé. Vous pouvez obtenir des fonctionnalités similaires dans la version 2 à l'aide de la méthode personnalisée listChildAccounts. L'arborescence complète des comptes enfants 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 a déjà été supprimé de l'interface utilisateur AdSense.
Le champ supports_reporting est remplacé par le champ reporting_dimension_id, qui représente l'ID unique du client publicitaire utilisé dans la dimension de rapport AD_CLIENT_ID. Si reporting_dimension_id est vide, AdClient n'accepte pas la création de rapports.

AdUnit

Le champ status a été renommé state. Par ailleurs, l'état ACTIVE n'indique plus si une activité a été enregistrée 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 a été limité aux valeurs TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT et LINK.
Les autres champs qui ont déjà été supprimés de l'interface utilisateur AdSense le sont également: 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 a déjà été supprimé de l'interface utilisateur AdSense.

Paiement

Le champ payment_date a été renommé date et le type "chaîne" a été remplacé par le type 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 £").

Rapport

Dans la version 2, les données de rapport de l'API AdSense Management correspondent désormais à celles de l'interface utilisateur AdSense. Cela signifie que les propriétés AdMob et YouTube ne sont plus acceptées. De plus, l'API n'acceptera 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 remplaçant les paramètres de requête dans 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 maintenant spécifier plusieurs plages communes avec date_range (par exemple, TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS et LAST_30_DAYS), ou spécifier start_date et end_date en définissant date_range sur CUSTOM.
- Les champs start_date et end_date sont passés de type chaîne au type google.type.Date. Remarque: Par conséquent, les mots clés basés sur des dates relatives (par exemple, "today-6d") ne sont plus prises en charge.
- 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 (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 lors de la génération de 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 a déjà été supprimé de l'interface utilisateur AdSense.

Site

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