Créez un carnet de lecture dans Google Sheets avec recherche par ISBN

Piotr Grudzień
Publié le 9 min de lecture
La ligne Pride and Prejudice achevée dans Google Sheets, à côté de la réponse de Quickchat AI qui retrouve sa note.

Qu’avez-vous écrit quand vous avez terminé Pride and Prejudice ? Dans ce carnet de lecture, la réponse est « I kept noticing who misunderstood whom. » (Je remarquais sans cesse qui comprenait qui de travers). Elle correspond à l’édition brochée Penguin, ISBN 9780141439518, terminée le 8 novembre. La phrase est toujours là quand vous ouvrez une nouvelle conversation.

Vous allez créer Shelf Notes, un suivi de lecture privé dans Google Sheets. Open Library fournit les détails de l’édition, vous ajoutez la date et l’idée que vous voulez conserver, et un Agent Quickchat AI les place sur la même ligne après votre confirmation.

L’entrée PAP-01 achevée dans Google Sheets et la note exacte du lecteur dans un nouveau chat Quickchat AI.
L’onglet Events comporte deux entrées pour PAP-01. La seconde contient la note du 8 novembre. Quickchat AI lit la feuille dans un nouveau chat et renvoie cette même phrase.

Téléchargez le kit de démarrage Shelf Notes. Ouvrez Shelf Notes.xlsx pour voir l’exemple terminé. Utilisez les deux fichiers TSV pour créer votre propre carnet dans Google Sheets. Ils vous font commencer une entrée plus tôt, pendant que la lecture est encore en cours. Le kit contient aussi les réglages exacts des Actions et le Main Prompt.

1. Quelle édition se trouve sur votre étagère ?

Essayez la recherche avant de connecter quoi que ce soit. Ouvrez l’édition pour l’ISBN 9780141439518. C’est une édition brochée en anglais de 435 pages publiée par Penguin Books en 2003. Le roman de Jane Austen a d’abord paru en 1813. Les deux dates appartiennent à Pride and Prejudice, mais une seule décrit l’exemplaire posé sur le bureau.

La fiche de l’édition dans Open Library et l’entrée proposée dans l’Inbox de Shelf Notes pour la même édition brochée de Penguin.
Repérez l’édition brochée de Penguin dans Open Library, puis vérifiez l’éditeur et l’année de publication dans l’entrée proposée par Quickchat AI avant de l’enregistrer.
  1. Créez un compte ou connectez-vous à Quickchat AI. Utilisez votre Agent vide, ou choisissez Add new AI Agent → Set up manually. Nommez-le Shelf Notes. Il vous faudra un compte Google pour le carnet et des crédits IA disponibles pour tester une conversation.
  2. Avant d’ajouter des notes personnelles, ouvrez Your Website → Install → Availability and access. Désactivez Widget & Embed access, réglez Chat Page Access sur Nobody et laissez les autres canaux déconnectés. Utilisez AI Preview dans votre tableau de bord une fois connecté.
  3. Sous Identity → Main Prompt, collez main-prompt.txt depuis le kit. Il indique à l’Agent d’afficher l’entrée proposée et d’attendre une confirmation distincte.
  4. Dans Actions & MCPs → Add Action → API Action → Create manually, créez les deux Actions GET ci-dessous. Pour chacune, utilisez When to run → AI decides, ajoutez un paramètre Text obligatoire nommé isbn sous What to ask the user first, et laissez le corps vide. Supprimez les espaces et les traits d’union du numéro, en conservant les zéros initiaux et un X final pour un ISBN-10.
Nom de l’actionPoint de terminaison APIÉléments à utiliser dans la réponse
lookup_book_isbnhttps://openlibrary.org/search.jsonDans Query Params, saisissez isbn={{isbn}}, fields=key,title,author_name,first_publish_year et limit=1. L’œuvre fournit l’auteur et l’année d’origine du roman.
lookup_editionhttps://openlibrary.org/isbn/{{isbn}}.jsonVérifiez que le numéro fourni apparaît dans isbn_13 ou isbn_10. Relevez l’éditeur, la date de cette édition et la langue quand ils sont présents. Ajoutez la clé /books/ renvoyée à https://openlibrary.org pour obtenir le lien source.

Le paramètre ISBN et la requête Open Library dans l’éditeur d’action de Quickchat AI. Saisissez l’ISBN dans la conversation. L’Action l’insère dans une URL dont l’hôte est fixé dans l’éditeur.

Notre première recherche demandait aussi la liste des éditions de l’œuvre. Pour cet ISBN précis, elle a renvoyé 4,042 identifiants d’édition. En retirant ce champ, nous avons obtenu une réponse courte avec l’autrice et l’année de parution originale. La deuxième requête a quand même renvoyé l’édition brochée que nous voulions.

Sous Headers, donnez à chaque requête un User-Agent de ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), en remplaçant l’adresse de contact d’exemple par la vôtre. Collez la API Action Description correspondante depuis action-recipes.md, enregistrez puis activez chaque Action. Essayez « Look up ISBN 978-0-14-143951-8. ». Vous devriez voir cette édition sans créer d’entrée dans le carnet de lecture. Cette recherche personnelle ne nécessite pas de compte Open Library. Utilisez-la quand quelqu’un pose une question sur un livre et suivez les consignes d’utilisation de l’API de Open Library.

2. Que faut-il mettre dans le carnet de lecture ?

Mettez les informations du catalogue et vos propres observations dans des colonnes séparées. Vous pourriez prêter à quelqu’un cette édition précise et ne pas être d’accord sur tous les personnages. L’ISBN reste le même. Votre note appartient à votre suivi de lecture, identifié ici par PAP-01.

  1. Ouvrez Actions & MCPs → Add Action → Google Sheets → Connect. Autorisez le compte Google qui possédera le carnet, puis choisissez Open sheet. La connexion crée une feuille de calcul dans Drive avec l’autorisation drive.file. Le guide de connexion à Google Sheets présente les écrans d’autorisation. Pour un journal personnel, ouvrez Partager dans Google Sheets et laissez Accès général sur Limité.
  2. Désactivez l’Action de démarrage active, log_lead_to_google_sheet. Conservez son nom et copiez son API Endpoint avec l’ID du fichier déjà rempli. Laissez l’Action de démarrage désactivée. Vous allez créer des Actions séparées pour ce carnet.

La connexion à Google Sheets dans Quickchat AI et l’écran de Google pour choisir le compte à utiliser avec Quickchat AI. Ouvrez le fichier créé pour cet Agent. L’Action de démarrage contient déjà l’ID de feuille de calcul dont vous avez besoin.

  1. Renommez l’onglet Leads en Events et remplacez son contenu par Events.tsv, en commençant à A1. Formatez les colonnes B (ISBN) et F (date) en Plain text avant de coller. Ajoutez un deuxième onglet nommé Status. Dans une nouvelle feuille d’exemple, utilisez File → Settings → Locale → United States pour que les formules ci-dessous acceptent les virgules.

L’onglet Events de Shelf Notes dans Google Sheets, avec l’entrée initiale Pride and Prejudice et l’onglet Status à côté. Commencez par la ligne 2. PAP-01 est toujours en cours de lecture, avec « Started with the Netherfield visit. » en G2. Après votre confirmation, l’entrée achevée apparaîtra à la ligne 3.

Les huit colonnes de Events, dans l’ordre, sont reading_id, isbn, title, edition_url, status, reading_date, note et conversation. La dernière cellule contient un lien de retour vers la conversation. Le premier événement du modèle indique reading le 2 novembre. Sa note est « Started with the Netherfield visit. ».

La ligne du carnet, répartie entre les champs du catalogue, les champs du lecteur et le lien vers la conversation. Conservez un seul identifiant de lecture pendant qu’un livre passe de reading à finished. Choisissez-en un nouveau quand vous revenez au livre pour une relecture.

3. Comment enregistrer une note de lecture à partir d’un ISBN ?

La recherche répond à « De quel livre s’agit-il ? ». L’enregistrement répond à une autre question : « Est-ce bien ce dont je veux me souvenir ? ». Configurez une Action pour ajouter la ligne confirmée et une autre pour vérifier ce que la feuille de calcul contient réellement.

  1. Créez une API Action nommée append_reading_event. Copiez l’URL Sheets de l’Action de démarrage, en conservant tout jusqu’à son véritable ID de fichier. Remplacez le reste par /values/Events!A:H:append. Réglez POST et ajoutez l’entrée Query Params valueInputOption=RAW. Le mode d’entrée brut préserve les ISBN et traite comme du texte une note qui commence par =.
  2. Dans Headers, réglez Authorization sur Bearer {{google_sheets_access_token}} et Content-Type sur application/json. Quickchat AI renseigne le jeton au moment de la requête.
  3. Ajoutez six paramètres Text obligatoires nommés reading_id, isbn, title, edition_url, status et reading_date. Ajoutez un paramètre Text facultatif nommé note avec une valeur par défaut vide. Choisissez reading, finished, paused ou abandoned pour le statut. Utilisez la date du lecteur au format YYYY-MM-DD.
  4. Dans API Endpoint → Body, collez le JSON ci-dessous. Les deux paires de crochets correspondent à une ligne de huit cellules. conversation_url est intégré. Collez la description d’ajout du kit dans API Action Description.
  5. Créez read_reading_journal comme une requête GET vers le même tableur, avec /values/Events!A2:H1000 à la fin de l’URL. Donnez-lui le même en-tête Bearer, la description de l’historique du kit, aucun paramètre et un corps vide. Enregistrez et activez les deux Actions.
{
  "values": [[
    "{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
    "{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
  ]]
}

Le réglage d’entrée RAW de l’Action d’ajout et les huit cellules de son corps JSON. Le tableau correspond aux colonnes A à H. En gardant la note en septième position, les mots du lecteur arrivent dans la colonne G.

Une fois la ligne initiale en place, envoyez le message suivant dans AI Preview.

Look up ISBN 978-0-14-143951-8. I finished PAP-01 on 2026-11-08. My note: I kept noticing who misunderstood whom.

Vérifiez l’édition proposée, l’ID, la date et la ponctuation. À ce stade, Events ne doit toujours contenir que l’entrée d’ouverture. Dites ensuite « Yes, that is my edition. Save PAP-01 with that status, date and note. ». Un deuxième événement doit apparaître à la ligne 3.

Shelf Notes affiche l’édition, la date et la note, puis demande l’autorisation d’enregistrer. Cette proposition vous donne un dernier aperçu de l’ISBN et de votre formulation. Vous pouvez corriger l’un ou l’autre avant que le carnet de lecture change.

Lors de notre essai en direct, la proposition a laissé la ligne initiale intacte. Après confirmation, Shelf Notes a vérifié le carnet, revérifié l’ISBN, ajouté une seule ligne, puis relu cette nouvelle ligne. Dans Inbox, dépliez append_reading_event et comparez le updates.updatedRange de Google avec les cellules de votre feuille. Si une requête expire, cherchez la ligne avant de réessayer. Référence Google Sheets sur l’ajout de lignes

L’ajout de ligne réussi par Quickchat AI et la note de lecture confirmée dans la cellule G3 de Google Sheets. Google a indiqué qu’une ligne et huit cellules avaient été mises à jour dans Events!A3:H3. Sélectionnez G3 pour comparer son texte avec la note que vous avez approuvée.

4. Que pouvez-vous demander dans une nouvelle conversation ?

Ouvrez une nouvelle conversation dans AI Preview et demandez « What was the last note I saved for PAP-01? ». Lors de notre test, l’Agent a relu Events et a renvoyé « I kept noticing who misunderstood whom. » La ligne 2 contient toujours la note antérieure sur Netherfield. Google peut omettre les cellules vides à la fin d’une ligne renvoyée, donc il est normal que le lien de conversation soit vide dans votre ligne initiale.

Pour « Which books am I still reading? », deux événements pour une même lecture donneraient une réponse trompeuse si vous comptiez chaque ligne. Utilisez l’onglet Status pour sélectionner le dernier événement ajouté pour chaque ID de lecture.

  1. Collez Status.tsv dans Status!A1. Sa formule en A2 liste chaque ID de lecture une seule fois. B2 utilise une recherche en correspondance exacte en partant du bas de Events. Recopiez B2 vers le bas à mesure que de nouveaux ID s’ajoutent à votre carnet de lecture. D2 compte les ID dont le dernier statut est finished.
  2. Créez read_reading_status, une autre requête GET avec le même en-tête bearer, en utilisant le suffixe /values/Status!A1:B1000. Collez la description de statut du kit, laissez le corps et les paramètres vides, puis enregistrez et activez-la.
  3. Demandez quels livres sont terminés. Dans l’exemple, Status contient une lecture terminée, PAP-01. Pour une deuxième lecture du roman, donnez-lui PAP-02. Vous pourrez alors distinguer ce que vous avez remarqué la première fois de ce que vous avez remarqué la deuxième.
Dans l’onglet Status de Google Sheets, le statut passe de reading à finished et le nombre de lectures terminées passe de zéro à une. Dans un nouveau chat, Shelf Notes renvoie finished.
Status!B2 affiche finished et D2 compte une lecture. Gardez Events dans l’ordre d’ajout, même pour les entrées antidatées. Utilisez une vue avec filtre pour le parcourir.
Copiez les trois formules Google Sheets

Status!A2 liste les identifiants.

=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)

Status!B2 recherche l’événement le plus récent pour l’ID de la colonne A.

=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))

Status!D2 compte les lectures terminées.

=COUNTIF(B2:B1000,"finished")

La recette couvre 999 événements. Avant qu’une nouvelle entrée n’arrive sous la ligne 1000, étendez ensemble les plages de lecture et les plages des formules. Gardez à l’esprit les notes longues et les grandes collections lorsque vous choisissez la quantité d’historique à renvoyer dans une seule conversation. Référence XLOOKUP de Google Sheets

5. Est-ce que cela fonctionne avec le livre posé sur votre bureau ?

Prenez un autre livre et essayez son ISBN imprimé. Demandez l’édition, puis arrêtez-vous là. Un bon premier contrôle consiste à vérifier que vous pouvez consulter un livre sans l’ajouter. Ensuite, donnez-lui un ID de lecture et une phrase que vous seriez le seul à pouvoir écrire. Confirmez-la, fermez le chat, puis redemandez cette phrase.

Pour des vérifications reproductibles, utilisez Testing → Simulation, puis consultez Actions & MCPs → View logs ainsi que les cellules de destination. Essayez un ISBN non reconnu, refusez une entrée proposée et enregistrez une note de test commençant par =1+1. Les deux premiers cas ne doivent pas modifier l’historique. Le dernier doit afficher les caractères littéraux dans la cellule de note.

Nous avons aussi fait en sorte que la feuille locale enregistre une ligne, puis dépasse le délai avant de répondre. Shelf Notes a relu la ligne, signalé l’expiration du délai et n’a effectué aucun deuxième ajout. Vous pouvez vérifier le même point dans le journal des actions si un enregistrement vous laisse un jour hésiter à appuyer de nouveau sur envoyer.

Open Library renvoie une édition introuvable et Shelf Notes demande au lecteur de vérifier l’ISBN. Dans le test d’édition introuvable, le catalogue a renvoyé 404. L’Agent a demandé un autre identifiant et le journal a conservé ses deux lignes.

Si vous préférez configurer l’Agent depuis un autre assistant, le kit inclut une demande de configuration pour le connecteur de compte Quickchat AI. Joignez action-recipes.md et main-prompt.txt, puis donnez-lui setup-request.txt. Passez en revue les cinq Actions, terminez vous-même l’autorisation de Google et lancez le même test de lecture. Connecteur ChatGPT · Connecteur Claude · Guide de configuration du compte

Questions fréquentes

Comment ajouter un livre à Google Sheets à partir de son ISBN ?

Utilisez l’ISBN imprimé sur votre exemplaire pour retrouver son édition dans Open Library. Vérifiez le titre, l’éditeur et l’année, ajoutez votre statut de lecture et votre note, puis confirmez la ligne. Le kit de départ comprend les en-têtes de feuille, les formules et les cinq recettes d’Action Quickchat AI.

Puis-je utiliser un suivi de lecture que j’ai déjà dans Google Sheets ?

Copiez les entrées que vous voulez dans l’onglet Events de la feuille de calcul créée par la connexion Quickchat AI. Respectez les huit colonnes et gardez les ISBN au format texte. Coller l’ID d’un autre fichier privé dans l’Action ne lui donne pas l’autorisation d’ouvrir ce fichier.

Que faire si Open Library ne trouve pas mon ISBN ?

Vérifiez le numéro sur le code-barres ou la page de droits, y compris un éventuel zéro initial ou un X final. Si l’édition ne peut toujours pas être vérifiée, ne modifiez pas le carnet. Un ISBN identifie une édition et ne donne pas accès au texte intégral du livre.

Comment compter les livres terminés et suivre les relectures ?

Donnez son propre identifiant à chaque lecture. Gardez cet identifiant quand vous mettez le livre en pause ou quand vous le terminez, et attribuez un nouvel identifiant à une relecture. Comptez les entrées terminées dans l’onglet Status. Deux lectures terminées de la même édition comptent alors deux fois, tandis que deux mises à jour d’une seule lecture ne comptent qu’une fois.

Puis-je retrouver une note de lecture après avoir fermé la conversation ?

Oui. Demandez le livre ou l’identifiant de lecture dans une nouvelle conversation privée. L’Action d’historique relit l’onglet Events, où sont enregistrées les entrées datées et votre formulation d’origine. L’onglet Status fournit l’état enregistré le plus récemment pour chaque lecture.

Quickchat AI Quickchat AI Ask Quickchat AI a question