Google Sheets

La recherche dans un tableur : une formule qui liste les sites web dont le code source contient un extrait de code, et un menu qui exporte toute une requête vers une nouvelle feuille. Libre de copie, fonctionne avec votre jeton d’API.

=PUBLICWWW(A1)                    websites whose page source contains the query in A1
=PUBLICWWW(A1, 50, "url,rank")    50 rows, only the url and rank columns
=PUBLICWWW_COUNT(A1)              how many websites match

Mise en place

1. Ouvrez une feuille de calcul, puis Extensions > Apps Script.
2. Remplacez le contenu de Code.gs par Code.gs provenant du dépôt, puis enregistrez.
3. Rechargez la feuille de calcul. Un menu PublicWWW apparaît ; choisissez Set API token et collez un jeton issu de votre page de profil. L’API nécessite un forfait payant.
4. Google demande une seule fois d’autoriser le script : il lit et modifie uniquement cette feuille de calcul et se connecte à api.publicwww.com.

Le jeton est conservé dans les propriétés du script : toute personne pouvant modifier le script de cette feuille de calcul peut donc le lire. Accordez les droits de modification en conséquence, ou attribuez à la feuille son propre jeton, que vous pourrez supprimer depuis la page de profil.

Écrire la requête

La requête est la même que dans le champ de recherche - voir la syntaxe des requêtes. Les guillemets comptent : "angular.min.js" avec les guillemets désigne exactement cette chaîne ; sans eux, il s’agit de plusieurs mots. Dans une formule, un guillemet s’écrit deux fois, =PUBLICWWW("""angular.min.js""") : il est donc plus simple de saisir la requête, guillemets compris, dans une cellule et d’y faire référence : =PUBLICWWW(A1).

Les fonctions

• PUBLICWWW(query, [rows], [columns], [header]) - un site web par ligne, les plus populaires en premier. rows - 10 par défaut, jusqu’à 1000 dans une formule. columns - au choix parmi domain, url, rank, séparés par des virgules ; les trois par défaut. header - TRUE place les noms des colonnes sur la première ligne. rank est vide pour un site sans rang de popularité ; si rien n’est trouvé, la cellule reste vide.
• PUBLICWWW_COUNT(query) - le nombre de sites web correspondants.

Une formule lance une recherche lorsqu’elle est saisie ou que ses arguments changent, et la réponse est conservée six heures : rouvrir la feuille ne consomme donc pas de nouvelles recherches. Chaque nouvelle formule compte pour une recherche dans le quota quotidien du forfait.

Exporter toute une requête

PublicWWW > Export a query to a new sheet écrit dans une nouvelle feuille toutes les lignes que votre forfait couvre pour la requête, avec les totaux dans une note sur sa première cellule. Un export très volumineux peut se heurter à la limite de Google de six minutes par exécution de script ; pour des listes de plusieurs centaines de milliers de lignes, interrogez directement l’API - format=csv s’ouvre dans n’importe quel tableur.

Quand une cellule affiche #ERROR!

Survolez la cellule pour en voir la raison.

Tous les codes : Erreurs.