Wat schreef je toen je Pride and Prejudice uitlas? In dit leesdagboek is het antwoord: “I kept noticing who misunderstood whom.” (Het viel me telkens weer op wie wie verkeerd begreep.) Het hoort bij de Penguin-paperback, ISBN 9780141439518, uitgelezen op 8 november. Die zin staat er nog steeds wanneer je een nieuw chatgesprek opent.
Je bouwt Shelf Notes, een privéleesdagboek in Google Spreadsheets. Open Library levert de editiegegevens, jij levert de datum en de gedachte die je wilt bewaren, en een Agent van Quickchat AI zet ze na jouw bevestiging in dezelfde rij.
Download de Shelf Notes-starterkit. Open Shelf Notes.xlsx om het voltooide voorbeeld te bekijken. Gebruik de twee TSV-bestanden om je eigen leesdagboek in Google Spreadsheets op te bouwen. Ze laten je één vermelding eerder beginnen, terwijl de lezer nog aan het lezen is. De kit bevat ook de exacte Action-instellingen en Main Prompt.
1. Welke editie staat er op je plank?
Probeer het opzoeken eerst voordat je iets koppelt. Open de editie voor ISBN 9780141439518. Het is een Engelstalige paperback van 435 pagina’s, uitgegeven door Penguin Books in 2003. Jane Austens roman verscheen voor het eerst in 1813. Beide jaartallen horen bij Pride and Prejudice, maar slechts één beschrijft het exemplaar op het bureau.
- Maak een account aan of log in bij Quickchat AI. Gebruik je lege Agent, of kies Add new AI Agent → Set up manually. Geef die de naam Shelf Notes. Je hebt een Google-account nodig voor het leesdagboek en beschikbare AI-credits om een gesprek te testen.
- Open Your Website → Install → Availability and access voordat je persoonlijke notities toevoegt. Zet Widget & Embed access uit, stel Chat Page Access in op Nobody en laat andere kanalen losgekoppeld. Gebruik AI Preview in je ingelogde dashboard.
- Plak onder Identity → Main Prompt
main-prompt.txtuit de kit. Daarmee krijgt de Agent de instructie om de voorgestelde vermelding te tonen en op een aparte bevestiging te wachten. - Maak in Actions & MCPs → Add Action → API Action → Create manually de twee GET-Actions hieronder. Gebruik voor allebei When to run → AI decides, voeg onder What to ask the user first één verplichte parameter van het type Text toe met de naam
isbn, en laat de body leeg. Verwijder spaties en koppeltekens uit het nummer, behoud voorloopnullen en een afsluitende ISBN-10-X.
| Actienaam | API-eindpunt | Wat je uit het resultaat gebruikt |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | Vul in Query Params isbn={{isbn}}, fields=key,title,author_name,first_publish_year en limit=1 in. Het werk levert de auteur en het oorspronkelijke jaar van de roman. |
lookup_edition | https://openlibrary.org/isbn/{{isbn}}.json | Controleer of het opgegeven nummer voorkomt in isbn_13 of isbn_10. Lees de uitgever, editiedatum en taal uit wanneer die aanwezig zijn. Voeg de teruggegeven sleutel /books/ toe aan https://openlibrary.org voor de bronlink. |
Typ het ISBN in het gesprek. De Action zet het in een URL waarvan de host vastligt in de editor.
Bij onze eerste zoekopdracht vroegen we ook de lijst met edities van het werk op. Voor dit ene ISBN leverde dat 4.042 editie-ID’s op. Toen we dat veld weghaalden, bleven de auteur en het oorspronkelijke jaar over in een kort antwoord. De tweede aanvraag gaf nog steeds die ene paperback terug die we wilden hebben.
Geef onder Headers elk verzoek een User-Agent met de waarde ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), en vervang het voorbeeldcontact door je eigen contact. Plak de bijpassende API Action Description uit action-recipes.md, sla elke Action op en schakel die in. Probeer “Look up ISBN 978-0-14-143951-8.”. Je zou de editie moeten zien zonder een vermelding in het leesdagboek aan te maken. Voor dit persoonlijke boeken opzoeken op ISBN heb je geen Open Library-account nodig. Gebruik het als iemand naar een boek vraagt en volg de API-gebruiksrichtlijnen van Open Library.
2. Wat hoort er in het leesdagboek?
Zet catalogusgegevens en je eigen observaties in aparte kolommen. Je kunt deze exacte editie aan iemand uitlenen en over elk personage van mening verschillen. Het ISBN blijft hetzelfde. Je notitie hoort bij jouw lezing, hier aangeduid als PAP-01.
- Open Actions & MCPs → Add Action → Google Sheets → Connect. Autoriseer het Google-account dat eigenaar van het leesdagboek wordt en kies daarna Open sheet. De koppeling maakt in Drive een spreadsheet aan onder de
drive.file-machtiging. In de uitleg voor de Google Spreadsheets-koppeling zie je de autorisatieschermen. Open voor je persoonlijke leesdagboek Delen in Google Spreadsheets en laat Algemene toegang op Beperkt staan. - Schakel de actieve starter-Action,
log_lead_to_google_sheet, uit. Laat de naam staan en kopieer het API Endpoint waarin de bestands-ID al is ingevuld. Laat de starter uitgeschakeld. Voor dit leesdagboek maak je aparte Actions.
Open het bestand dat voor deze Agent is aangemaakt. De starter-Action bevat al de spreadsheet-ID die je nodig hebt.
- Hernoem het tabblad Leads naar Events en vervang de inhoud door
Events.tsv, beginnend bij A1. Formatteer vóór het plakken kolommen B (ISBN) en F (datum) als Plain text. Voeg een tweede tabblad toe met de naam Status. Gebruik in een nieuw voorbeeldblad File → Settings → Locale → United States zodat de formules hieronder komma’s accepteren.
Begin met rij 2. Voor PAP-01 ben je nog aan het lezen, met “Started with the Netherfield visit.” in G2. Nadat je bevestigt, verschijnt de voltooide vermelding in rij 3.
De acht kolommen in Events zijn, in deze volgorde, reading_id, isbn, title, edition_url, status, reading_date, note en conversation. De laatste cel bevat een link terug naar het gesprek. De eerste gebeurtenis van de starter heeft op 2 november de status reading. De notitie daarbij is “Started with the Netherfield visit.”
Houd één reading ID aan terwijl een boek van reading naar finished gaat. Kies een nieuwe wanneer je later naar het boek terugkeert om het te herlezen.
3. Hoe sla je een leesnotitie op via ISBN?
Het opzoeken beantwoordt de vraag: “Welk boek?” Opslaan beantwoordt een andere vraag: “Is dit wat ik wil onthouden?” Stel één Action in om de bevestigde rij toe te voegen en een tweede om te controleren wat er echt in de spreadsheet staat.
- Maak een API Action met de naam
append_reading_event. Kopieer de Sheets-URL van de starter en behoud alles tot en met de daadwerkelijke bestands-ID. Vervang de rest door/values/Events!A:H:append. Stel POST in en voeg in Query Params de vermeldingvalueInputOption=RAWtoe. De modus voor ruwe invoer bewaart ISBN’s en behandelt een notitie die begint met=als tekst. - Stel in Headers
Authorizationin opBearer {{google_sheets_access_token}}enContent-Typeopapplication/json. Quickchat AI vult het token tijdens de aanvraag in. - Voeg zes verplichte parameters van het type Text toe met de namen
reading_id,isbn,title,edition_url,statusenreading_date. Voeg een optionele parameter van het type Text toe met de naamnoteen een lege standaardwaarde. Kies voor statusreading,finished,pausedofabandoned. Gebruik voor de datum van de lezerYYYY-MM-DD. - Plak in API Endpoint → Body de JSON hieronder. De twee paar haakjes betekenen één rij met acht cellen.
conversation_urlis ingebouwd. Plak de append-beschrijving uit de kit in API Action Description. - Maak
read_reading_journalals een GET naar dezelfde spreadsheet, eindigend op/values/Events!A2:H1000. Geef het dezelfde bearer-header, de history-beschrijving uit de kit, geen parameters en een lege body. Sla beide Actions op en schakel ze in.
{
"values": [[
"{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
"{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
]]
}
De array komt overeen met kolommen A tot en met H. Door de notitie op de zevende positie te houden, komen de woorden van de lezer in kolom G terecht.
Met de startrij op zijn plaats stuur je het volgende bericht in 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.
Controleer de voorgestelde editie, ID, datum en interpunctie. Op dit punt zou Events nog steeds alleen de openingsrij moeten bevatten. Zeg daarna “Yes, that is my edition. Save PAP-01 with that status, date and note.”. Er zou een tweede gebeurtenis op rij 3 moeten verschijnen.
Het voorstel geeft je nog één laatste blik op de ISBN en je formulering. Je kunt beide nog aanpassen voordat het leesdagboek verandert.
In onze live run liet het voorstel de openingsrij ongemoeid. Na je bevestiging controleerde Shelf Notes het leesdagboek, controleerde de ISBN opnieuw, voegde precies één rij toe en las die nieuwe rij ter controle terug. Klap in Inbox append_reading_event open en vergelijk Googles updates.updatedRange met de cellen in je spreadsheet. Als een verzoek een time-out geeft, zoek dan eerst naar de rij voordat je het opnieuw probeert. Naslag over rijen toevoegen in Google Spreadsheets
Google meldde dat één rij en acht cellen waren bijgewerkt op Events!A3:H3. Selecteer G3 om de tekst te vergelijken met de notitie die je goedkeurde.
4. Wat kun je in een nieuwe chat vragen?
Open een nieuw gesprek in AI Preview en vraag “What was the last note I saved for PAP-01?”. In onze test las de Agent Events opnieuw en gaf “I kept noticing who misunderstood whom.” terug. Rij 2 bevat nog steeds de eerdere notitie over Netherfield. Google kan lege cellen aan het einde van een geretourneerde rij weglaten, dus een lege gesprekslink in je startrij is te verwachten.
Voor “Which books am I still reading?” zouden twee gebeurtenissen voor één reading een misleidend antwoord geven als je elke rij telt. Gebruik het tabblad Status om voor elke reading ID de laatst toegevoegde gebeurtenis te selecteren.
- Plak
Status.tsvin Status!A1. De formule in A2 zet elke reading ID één keer in de lijst. B2 gebruikt een exacte zoekopdracht die onderaan in Events begint. Vul B2 naar beneden aan naast nieuwe ID’s terwijl je plank groeit. D2 telt ID’s waarvan de nieuwste statusfinishedis. - Maak
read_reading_status, nog een GET met dezelfde bearer-header, met als suffix/values/Status!A1:B1000. Plak de statusbeschrijving van de kit, laat body en parameters leeg en sla het daarna op en schakel het in. - Vraag welke boeken de status finished hebben. In het voorbeeld heeft Status één voltooide leesronde,
PAP-01. Geef een tweede leesronde van de romanPAP-02. Zo kun je onderscheiden wat je de eerste keer opviel van wat je de tweede keer opviel.
Kopieer de drie formules voor Google Spreadsheets
Status!A2 bevat de ID’s.
=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)
Status!B2 zoekt de meest recente gebeurtenis op voor de ID in kolom A.
=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))
Status!D2 telt het aantal voltooide leesrondes.
=COUNTIF(B2:B1000,"finished")
Het recept dekt 999 gebeurtenissen. Voordat een nieuwe vermelding onder rij 1000 terechtkomt, verleng je de leesbereiken en formulebereiken samen. Houd lange notities en grote collecties in gedachten wanneer je kiest hoeveel geschiedenis je in één gesprek wilt teruggeven. XLOOKUP in Google Sheets
5. Werkt het met het boek op je bureau?
Pak een ander boek en probeer het gedrukte ISBN. Vraag naar de editie en stop dan. Een goede eerste controle is dat je een boek kunt bekijken zonder het toe te voegen. Geef het daarna een lees-ID en een zin die alleen jij had kunnen schrijven. Bevestig die, sluit de chat en vraag die zin weer op.
Gebruik voor herhaalbare controles Testing → Simulation en bekijk daarna Actions & MCPs → View logs en de doelcellen. Probeer een onbekend ISBN, wijs een voorgestelde invoer af en sla een testnotitie op die begint met =1+1. Bij de eerste twee moet de geschiedenis ongewijzigd blijven. Bij de laatste moeten de letterlijke tekens in de notitiecel komen te staan.
We lieten het lokale sheet ook eerst een rij opslaan en daarna een time-out geven voordat er een antwoord kwam. Shelf Notes las die rij weer uit, meldde de time-out en voegde geen tweede rij toe. Je kunt hetzelfde detail ook in het actielogboek bekijken als je na het opslaan ooit twijfelt of je nog eens op verzenden moet drukken.
In de test met de ontbrekende editie gaf de catalogus 404 terug. De Agent vroeg om een andere identificatiecode en het leesdagboek behield zijn twee rijen.
Als je de Agent liever vanuit een andere assistent instelt, bevat de kit een configuratieverzoek voor de accountconnector van Quickchat AI. Voeg action-recipes.md en main-prompt.txt toe en geef vervolgens setup-request.txt mee. Controleer de vijf Actions, rond zelf de autorisatie van Google af en voer dezelfde leestest uit. ChatGPT-connector · Claude-connector · Account instellen
Veelgestelde vragen
Hoe voeg ik met een ISBN een boek toe aan Google Spreadsheets?
Gebruik het ISBN dat in jouw exemplaar staat om de editie in Open Library op te zoeken. Controleer de titel, uitgever en het jaar, voeg je leesstatus en notitie toe en bevestig daarna de rij. De starterkit bevat de kolomkoppen van het werkblad, formules en alle vijf Action-recepten van Quickchat AI.
Kan ik een leesdagboek gebruiken dat ik al in Google Spreadsheets heb?
Kopieer de vermeldingen die je wilt overzetten naar het tabblad Events van het spreadsheet dat is gemaakt via de koppeling van Quickchat AI. Laat de acht kolommen overeenkomen en bewaar ISBN’s als tekst. Als je de ID van een ander privébestand in de Action plakt, krijgt die daarmee nog geen toestemming om dat bestand te openen.
Wat als Open Library mijn ISBN niet kan vinden?
Controleer het nummer bij de barcode of op de copyrightpagina, inclusief een eventuele voorloopnul of een afsluitende X. Als de editie nog steeds niet kan worden bevestigd, laat je het leesdagboek ongewijzigd. Een ISBN identificeert een editie en geeft geen toegang tot de volledige tekst van het boek.
Hoe tel ik uitgelezen boeken en houd ik herlezingen bij?
Geef elke leesbeurt een eigen ID. Houd die ID aan als je stopt of het boek uitleest, en geef een herlezing een nieuwe ID. Tel voltooide vermeldingen op het tabblad Status. Twee voltooide leesbeurten van dezelfde editie tellen dan twee keer, terwijl twee updates van één leesbeurt één keer tellen.
Kan ik een leesnotitie terugvinden nadat ik de chat heb gesloten?
Ja. Vraag in een nieuwe privéchat om het boek of de lees-ID. De history-Action leest het tabblad Events opnieuw, waar de gedateerde vermeldingen en je oorspronkelijke formulering zijn opgeslagen. Het tabblad Status levert de meest recent vastgelegde status voor elke lezing.