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
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
- Le champ account_id a été renommé en
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é
- Champs de date ajoutés (date_range, start_date,
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.