Connexion à Google Sheets

Google Sheets fait partie de Google Office. Comme il comporte déjà une fonction « importXML », les données de l'API Toolbox peuvent être importées rapidement et facilement. Nous allons vous montrer comment cela fonctionne dans ce document.

Google Sheets, d’abord connu sous le nom de Google Docs, est la réponse basée sur le web de Google à Microsoft Excel. Il fonctionne entièrement dans votre navigateur et sauvegarde toutes les données dans le Google Cloud. Par conséquent, il n’est pas limité à une plateforme et un document peut être visionné et édité par de nombreux utilisateurs en même temps.

Créer un nouveau document Sheets

Dans la première étape, nous allons créer une nouvelle feuille de calcul dans Google Docs. Pour cela, allez à l’URL suivante dans votre navigateur :

https://docs.google.com/spreadsheets/u/0/

Maintenant cliquez sur le gros bouton « plus » rouge dans le coin inférieur droit de votre navigateur. Un nouveau document Sheets est créé et vous pouvez dès à présent commencer à l’éditer.

Faire le lien avec l’API en utilisant importXML

Avec la fonction « importXML », Google Sheets vous donne l’opportunité d’importer des contenus XML externes dans votre document Sheets. Sachant que l’API SISTRIX donne également les données en format XML, il est facile de faire le lien entre les deux systèmes.

Pour utiliser cette fonction, il suffit de taper dans une cellule en commençant par le symbole égal et ajouter deux points de donnée :

=importXML("URL"; "XPath-Request")

Dans le champ URL, vous devez entrer l’URL exacte de l’API SISTRIX incluant votre clé API et tous les paramètres. Vous pouvez demander ou visualiser votre clé API sur ce site. Une vue d’ensemble de toutes les méthodes de l’API est disponible dans la documentation existante. Afin de récupérer la vue d’ensemble de domaine pour le domaine sistrix.fr, par exemple, entrez cette URL :

https://api.sistrix.com/domain.overview?api_key=YOURAPIKEY&domain=sistrix.fr

Le second champ de la fonction décrit les données exactes de la réponse XML qui doit être copiée dans votre feuille de calcul Google. Cette description est donnée sous forme d’une définition XPath. XPath peut sembler un peu cryptique à première vue, mais vous vous y habituerez très rapidement et les réponses à l’API SISTRIX contiennent uniquement de simples XML.

Avec un testeur XPath comme celui de Codebeautify.org, vous pouvez parvenir rapidement à des résultats. Sur cette page, vous pouvez charger le fichier XML de l’API avec le bouton « Load URL » et tester les variations XPath possibles en bas de page. Vous verrez ensuite le résultat sur le côté droit.

Dans l’exemple ci-dessus, vous obtenez la vue d’ensemble de domaine de la page avec cette expression :

//@value

Après avoir entré la fonction,

=importXML("https://api.sistrix.com/domain.overview?api_key=YOURAPIKEY&domain=sistrix.fr"; "//@value")

Google exécutera la requête de l’API et insérera les données actuelles depuis l’API SISTRIX dans votre feuille de calcul Google. Toutes les autres méthodes de l’API peuvent être incorporées de façon analogue à ce processus.

Sources supplémentaires