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.
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.
- 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.
- 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é.
- Sous Identity → Main Prompt, collez
main-prompt.txtdepuis le kit. Il indique à l’Agent d’afficher l’entrée proposée et d’attendre une confirmation distincte. - 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é
isbnsous 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 unXfinal pour un ISBN-10.
| Nom de l’action | Point de terminaison API | Éléments à utiliser dans la réponse |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | Dans 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_edition | https://openlibrary.org/isbn/{{isbn}}.json | Vé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. |
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.
- 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é. - 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.
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.
- 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.
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. ».
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.
- 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 ParamsvalueInputOption=RAW. Le mode d’entrée brut préserve les ISBN et traite comme du texte une note qui commence par=. - Dans Headers, réglez
AuthorizationsurBearer {{google_sheets_access_token}}etContent-Typesurapplication/json. Quickchat AI renseigne le jeton au moment de la requête. - Ajoutez six paramètres Text obligatoires nommés
reading_id,isbn,title,edition_url,statusetreading_date. Ajoutez un paramètre Text facultatif nomménoteavec une valeur par défaut vide. Choisissezreading,finished,pausedouabandonedpour le statut. Utilisez la date du lecteur au formatYYYY-MM-DD. - Dans API Endpoint → Body, collez le JSON ci-dessous. Les deux paires de crochets correspondent à une ligne de huit cellules.
conversation_urlest intégré. Collez la description d’ajout du kit dans API Action Description. - Créez
read_reading_journalcomme 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 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.
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
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.
- Collez
Status.tsvdans 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 estfinished. - 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. - 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-luiPAP-02. Vous pourrez alors distinguer ce que vous avez remarqué la première fois de ce que vous avez remarqué la deuxième.
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.
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.