API Google AdSense Management version 2.0

Google a récemment lancé une nouvelle API AdSense Management. Cela va de la version 1.4 jusqu’à la version 2.0 avec cette mise à jour. La version 1.4 cessera de fonctionner le 12 octobre 2021. Google a également mis à jour l’API hôte AdSense. Google a lancé la version 2 de l’API AdSense Management. Veuillez noter que la version actuelle de l’API AdSense Management, version 1.4, cessera de renvoyer des réponses le 12 octobre 2021. Voici une liste des fonctionnalités ajoutées ou modifiées dans la version 2.0:Général

Toutes les méthodes obsolètes de la v1.4 ont été supprimées. Cela comprend la ressource
méthodes qui ne nécessitaient pas de accountId. Dans la v2, le
accountId est spécifié dans le champ parent
Conformément aux normes de l’API Google, les ressources sont désormais identifiées par un
champ de nom. Par exemple, le nom d’un AdClient ressemblerait à
accounts / {accountId} / adclients / {adClientId}. De plus, dans
v1.4 l’ID de ressource a été utilisé comme dimension de rapport, mais dans la v2
La 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 de nom a été changé en
Afficher un nom
Le champ de fuseau horaire est passé d’une chaîne à une
google.type.TimeZone
Le champ creation_time (type int64) a été changé en
create_time (tapez google.protobuf.Timestamp)
Ajout d’un champ pending_tasks qui est une liste des
tâches qui doivent être effectuées dans le cadre du processus d’inscription pour un nouveau
Compte. Par exemple, les tâches peuvent être liées à votre profil de facturation ou
vérification par téléphone
Le champ sub_accounts a été supprimé. Similaire
la fonctionnalité peut être obtenue dans la v2 avec le listChildAccounts
méthode personnalisée. L’arborescence complète des comptes enfants peut être générée dans la v2 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’ID unique
du client publicitaire tel qu’utilisé dans le rapport AD_CLIENT_ID
dimension. Si reporting_dimension_id est vide, alors le
AdClient ne prend pas en charge la création de rapports

AdUnit

Le champ d’état a été renommé en état.
De plus, l’état ACTIVE n’indique plus s’il y a
activité sur ce bloc d’annonces au cours des sept derniers jours. Dans la v2, cela signifie l’annonce
l’unité a été activée par l’utilisateur et peut diffuser des annonces
Le champ de code a été supprimé. Cette valeur peut encore être
trouvé à la fin du champ de nom (après le dernier renvoi
sabrer)
Le champ contentAdsSettings.backupOption a été
supprimé
Le champ type a été limité aux valeurs
TYPE_UNSPECIFIED, DISPLAY, FEED,
ARTICLE, MATCHED_CONTENT et
RELIER
Les autres champs qui ont déjà été supprimés dans l’interface utilisateur AdSense sont également
supprimé: custom_style, saved_style_id,
mobile_content_ads_settings,
feed_ads_settings

Alerte

La méthode de suppression a été supprimée
Le champ is_dismissible a été supprimé
Le champ des paramètres régionaux a été renommé en
code_langue

CustomChannel

Le champ de code a été supprimé. Cette valeur peut encore être
trouvé à la fin du champ de nom (après le dernier renvoi
sabrer)
Le champ ciblage_info a été supprimé car il a
a déjà été supprimé de l’interface utilisateur AdSense

Paiement

Le champ date_paiement a été renommé à ce jour
et est passé de la chaîne de type au type google.type.Date
Le champ payment_amount et le
Le champ payment_amount_currency_code a été combiné en un
champ de paiement unique (par exemple, « 1 235 ¥ JPY », « 1 234,57 USD »,
«87,65 £»)

Signaler

Avec la version 2, les données de rapport de l’API AdSense Management correspondent désormais à la
Interface utilisateur AdSense. Cela signifie que les propriétés AdMob et YouTube ne sont plus
prise en charge. De plus, l’API ne prendra en charge que les données de rapport remontant à 3
années
La ressource Metadata.dimensions et le
La ressource Metadata.metrics a été supprimée
De nouvelles méthodes ont été ajoutées pour générer une version CSV du rapport,
remplacement des paramètres de requête dans la v1.4. Remarque: pour la compression, vous pouvez
utilisez toujours 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é en
  Compte
- Le champ de dimension a été renommé en
  dimensions
- Le champ de métrique a été renommé en
  métrique
- Le champ de filtre a été renommé en
  filtres
- Le champ de tri a été renommé en
  commandé par
- Le champ des paramètres régionaux a été renommé en
  code_langue
- Le champ de devise a été renommé en
  code de devise
- Vous pouvez maintenant spécifier plusieurs plages communes avec date_range
  (par exemple, AUJOURD’HUI, HIER,
  MONTH_TO_DATE, YEAR_TO_DATE,
  LAST_7_DAYS et LAST_30_DAYS), ou vous pouvez
  spécifiez une date de début et une date de fin en définissant
  date_range à CUSTOM
- Les champs start_date et end_date ont été
  modifié de la chaîne de type au type google.type.Date. Remarque: comme
  un résultat, les mots clés de date relative (par exemple, « aujourd’hui-6j ») ne sont plus
  prise en charge
- Le champ booléen use_timezone_reporting a été
  remplacé par reporting_time_zone, qui peut avoir l’un des
  deux valeurs: ACCOUNT_TIME_ZONE ou
  GOOGLE_TIME_ZONE (ce qui signifie PST / PDT). La valeur par défaut dans la v2
  est ACCOUNT_TIME_ZONE, ce qui diffère de la valeur par défaut dans
  v1.4
- Le champ start_index a été supprimé
- Le champ max_results a été renommé en
  limite
Certains champs ont été modifiés lors de la génération de rapports enregistrés.
- Champs de date ajoutés (date_range, start_date,
  end_date, reporting_time_zone)
- Ajout d’un champ currency_code
- Le champ des paramètres régionaux a été renommé en
  code_langue
- 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

Placer

Des sites ont été ajoutés pour récupérer des données sur les sites Web que vous avez ajoutés
à votre compte AdSense.
Le champ d’état indique si le site est l’un des
états suivants: REQUIRES_REVIEW,
GETTING_READY, PRÊT,
BESOIN D’ATTENTION
Le champ auto_ads_enabled est un booléen qui représente
si les annonces automatiques ont été activées sur un site particulier

Discussion sur le forum sur Twitter.

Partagez

Tweetez

Partagez