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 des API Google, cette version sera mise à jour au fil du temps pour inclure des fonctionnalités supplémentaires (rétrocompatibles) au lieu de publier des versions mineures distinctes.

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 publicitaires (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 certaines 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

AdClient

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é. Une fois 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 liste des 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 de ressources pour les revenus AdSense restent inchangés.
    • accounts/{account}/payments/unpaid pour 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 pour indiquer la façon dont une annonce est diffusée auprès des utilisateurs sur votre site (encart, vignette, etc.). Notez que la version 1.4 comportait des dimensions (obsolètes) portant les mêmes noms, mais dont les membres sont différents. Les deux dimensions ajoutées dans la version 2 sont distinctes 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 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 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 n'était plus une chaîne, mais 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 qui doivent être effectuées dans le cadre du processus d'inscription à un nouveau compte. Elles peuvent par exemple ê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 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 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'est pas compatible avec la création de 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é. Vous pouvez toujours trouver cette valeur à 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é. Vous pouvez toujours trouver cette valeur à 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 ¥", "1 234,57 $", "87,65 £").

Rapport

  • Avec 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 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 start_date et end_date en définissant date_range sur CUSTOM.
    • Les champs start_date et end_date ont été modifiés de 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 pris 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). Dans la version 2, la valeur par défaut est ACCOUNT_TIME_ZONE, ce qui diffère de la valeur par défaut de 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 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'UI 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.

Version 1.4

Cette version présente les fonctionnalités suivantes:

  • Vous pouvez à présent indiquer les paiements de votre compte AdSense dans la devise correspondante.
  • Vous pouvez maintenant ignorer une alerte en appelant la méthode delete, qui la masquera dans l'API et dans l'interface Web AdSense.
  • La réponse au rapport inclut désormais des dates de début et de fin. Ce point est important si vous utilisez des dates relatives lorsque vous générez des rapports (tels que today, yesterday ou firstDayOfMonth-1m). La réponse inclut désormais la plage de dates demandée.

Problèmes connus

Le champ "currency" dans les rapports n'est pas compatible avec cette version.

Version 1.3

Cette version présente les fonctionnalités suivantes:

  • Possibilité de récupérer des alertes
  • Possibilité de récupérer des métadonnées sur les métriques et les dimensions
  • La possibilité d'exécuter des rapports dans le fuseau horaire local du compte

Problèmes connus

Le champ "currency" dans les rapports n'est pas compatible avec cette version.

Version 1.2

Cette version présente les fonctionnalités suivantes:

  • Possibilité de récupérer des styles d'annonces
  • Possibilité de récupérer et d'exécuter les rapports enregistrés définis dans l'interface

Problèmes connus

Le champ "currency" dans les rapports n'est pas compatible avec cette version.

Version 1.1

Cette version présente les fonctionnalités suivantes:

  • Possibilité de lister les comptes auxquels l'utilisateur a accès
  • La possibilité d'effectuer un appel "GET" sur un compte spécifique
  • Possibilité d'effectuer des appels "GET" sur les blocs d'annonces et les critères personnalisés
  • La possibilité d'identifier les connexions entre les blocs d'annonces et les critères personnalisés
  • Les critères personnalisés contiennent davantage de données sur les informations de ciblage.

De plus, vous pouvez désormais accéder aux données à partir de votre compte par défaut ou d'un compte spécifique.

Problèmes connus

Le champ "currency" dans les rapports n'est pas compatible avec cette version.

Version 1

Il s'agit de la première version de l'API. Elle permet de récupérer des clients publicitaires, des blocs d'annonces, des critères personnalisés et des critères d'URL, ainsi que de générer des rapports.

Problèmes connus

Le champ "currency" dans les rapports n'est pas compatible avec cette version.