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

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.