Mises à jour de l'API Search Console

Mercredi 9 décembre 2020

Il y a quelques mois, nous avons annoncé une mise à niveau de l’infrastructure de l’API
pour améliorer les performances de Search Console API face à la demande croissante. Aujourd’hui, nous sommes heureux de vous annoncer de nouvelles mises à jour :

• Ajout de données récentes et d’un filtre d’actualités dans la Search Console API
• Prise en charge des propriétés de domaine dans l’API Sitemaps
• Instructions sur la façon de migrer le document Discovery

Si vous effectuez vos propres appels à l’API, lisez la suite.

Données récentes et filtre d’actualités dans la Search Console API

Le rapport sur les performances prend déjà en charge les données récentes datant de moins d’un jour. Vous pouvez désormais accéder à ces données via l’API en passant le paramètre de requête
dataState avec la valeur définie sur all. Les données obtenues pour cette valeur incluront également des données récentes qui ne sont pas encore définitives. Si vous souhaitez obtenir uniquement des données définitives, final vous pouvez soit passer ce paramètre avec cette valeur, soit ne pas le passer du tout et vous obtiendrez uniquement des données définitives par défaut.

Il y a quelques mois, nous avons ajouté un onglet Actualités dans le filtre de recherche au rapport sur les performances . Ces informations sont désormais également disponibles dans l'API, et vous pouvez y accéder en définissant la valeur du paramètre
searchType dans la requête sur.

news

Prise en charge des propriétés de domaine dans l’API Sitemaps
L’API Sitemaps prend désormais en charge les propriétés de domaine, comme le font déjà les autres API Search Console. Vous pouvez interroger, ajouter et supprimer vos sitemaps sur despropriétés de domaine

, par exemple :

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

Migration du document Discovery Nous allons supprimer la prise en charge dans le document de découverte Webmasters. Si vous interrogez la Search Console API à l’aide d’unebibliothèque API externe , ou si vous interrogez le document de découverte de l’API Webmasters

directement, vous devrez mettre à jour vos appels API pour inclure les modifications suivantes.

Modifications de la bibliothèque API Pour les mises à jour concernant les modifications de la bibliothèque API, consultez les guides de démarrage rapide Java
et Python

pour obtenir un guide d’utilisation actualisé de l’API.

Java Pour tous les imports liés au service Webmasters, remplacez le package webmasters par le package searchconsole.v1 , et le nom du service,Webmasters , parSearchConsole

• . Exemples :

  Importation du service API :

  import com.google.api.services.webmasters.Webmasters;

• import com.google.api.services.searchconsole.v1.SearchConsole;

  Importation d'un objet de réponse :

  import com.google.api.services.webmasters.model.WmxSite;

import com.google.api.services.searchconsole.v1.model.WmxSite; Notez qu’à part l’objet de service, les autres objets API sont exactement les mêmes qu’avant, seul le package

change.

Python

Lors de la création de l'objet de service Webmasters, apportez la modification suivante :

webmasters_service = build('webmasters', 'v3', http=http)

webmasters_service = build(‘searchconsole’, ‘v1’, http=http)

Encore une fois, il n’y a aucun changement dans le comportement des objets.

Requête directe du document Discovery

• Les modifications de requête du document Discovery incluent :

  Changement d'URL

  https://www.googleapis.com/discovery/v1/apis/webmasters/v3/rest

• https://searchconsole.googleapis.com/$discovery/rest
  • Changement de contenu Le name champ est passé de webmasters à searchconsole supplément searchconsole.
  • The version field changed from v3 to v1.

If you have any questions, you can ask in the Search Central community ou on Twitter.

Posted by Nati Yosephian, Gilad Amar, and Michael Huzman, Search Console team