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

Notes de version

Cette page fournit les notes de version de 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.

2025-02-24

PolicyIssues

Ajout d'un champ policyTopics[].type pour indiquer si un sujet de règles représente un problème concernant les règles, un problème réglementaire ou une préférence des annonceurs. Il remplace policyTopics[].must_fix, qui est désormais marqué comme champ obsolète.

2024-04-03

PolicyIssues

Ajout d'une nouvelle collection pour signaler les cas de non-respect des règles et les avertissements actuels d'un compte.

2023-06-19

Paiements

payments.list renvoie désormais des informations sur les paiements des é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 unités autres que des annonces (par exemple, les unités 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 exceptions, consultez la section Répartition par URL de page).

2022-09-21

AdUnits

Ajout des méthodes "create" et "patch". Notez que ces méthodes ne peuvent être utilisées que par les projets pour lesquels le produit AdSense pour les plates-formes est activé.

CustomChannels

Ajout des méthodes Create, Patch et Update. Notez que ces méthodes ne peuvent être utilisées que par les projets pour lesquels le produit AdSense pour les plates-formes est activé.
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 plate-forme de ventiler les métriques par compte de leur éditeur (éditeurs hôtes) et par sous-compte (é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

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 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 de 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 l'expérience AdSense améliorée 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 à partir de la méthode de liste de paiements une fois que vous disposerez d'un compte de paiement dédié pour vos revenus YouTube. Les revenus YouTube ont le format de nom de ressource suivant :
- accounts/{account}/payments/youtube-unpaid pour les revenus YouTube impayés (actuels).
- accounts/{account}/payments/youtube-aaaa-mm-jj pour les revenus YouTube payants
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

Ajout des dimensions AD_FORMAT_NAME et AD_FORMAT_CODE, qui indiquent la manière dont une annonce est diffusée auprès des utilisateurs de votre site (dans la page, vignette, etc.). Notez que la version 1.4 comportait des dimensions (obsolètes) portant le même nom, mais avec des membres différents. Les deux dimensions ajoutées dans la version 2 sont distinctes de celles qui étaient 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 ressemble à 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 de tâches en attente à effectuer dans le cadre de la procédure d'inscription d'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 des comptes enfant peut être générée dans la version 2 en appelant listChildAccounts de manière récursive.

AdClient

Suppression du champ arc_opt_in, 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'identifiant unique du client publicitaire tel qu'il est utilisé dans la dimension de création de rapports AD_CLIENT_ID. Si reporting_dimension_id est vide, AdClient n'est pas compatible avec les rapports.

AdUnit

Le champ status a été renommé state. De plus, 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 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.
D'autres champs déjà supprimés dans l'interface utilisateur d'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 a déjà été supprimé de l'interface utilisateur AdSense.

Paiement

Le champ payment_date a été renommé date et est passé du type de chaîne au type google.type.Date.
Le champ payment_amount et le champ payment_amount_currency_code ont été combinés en un seul champ payment (par exemple, "1 235 ¥", "1 234,57 $", "87,65 £").

Rapport

Avec la version 2, les données de rapport de l'API AdSense Management correspondent désormais à l'interface utilisateur AdSense. Cela signifie que les propriétés AdMob et YouTube ne sont plus acceptées. De plus, l'API n'est compatible qu'avec les données des rapports remontant à trois ans.
La ressource Metadata.dimensions et la ressource Metadata.metrics ont été supprimées.
De nouvelles méthodes ont été ajoutées pour générer une version CSV du rapport, remplaçant les 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 ont été remplacés par le type google.type.Date. Remarque: Par conséquent, les mots clés de date relatifs (par exemple, "today-6d") ne sont plus acceptés.
- Le champ booléen use_timezone_reporting a été remplacé par reporting_time_zone, qui peut prendre 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 pour la génération de rapports enregistrés.
- Ajout de champs de date (date_range, start_date, end_date et 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

Sites ont été ajoutés pour extraire 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 particulier.