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 // adclients /. 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

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

    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.