Maak een leesdagboek in Google Spreadsheets met een ISBN-zoekfunctie

Piotr Grudzień
Gepubliceerd 9 min leestijd
De voltooide Pride and Prejudice-rij in Google Spreadsheets naast het antwoord waarin Quickchat AI de notitie noemt.

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.

De voltooide PAP-01-vermelding in Google Spreadsheets en de exacte notitie van de lezer in een nieuw Quickchat AI-gesprek.
Het tabblad Events heeft twee vermeldingen voor PAP-01. De tweede bevat de notitie van 8 november. In een nieuw Quickchat AI-gesprek leest de Agent het spreadsheet en geeft dezelfde zin terug.

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.

De editiepagina in Open Library en het voorstel in de Shelf Notes Inbox voor dezelfde paperback van Penguin.
Zoek de paperback van Penguin op in Open Library en controleer daarna de uitgever en het jaar in het voorstel van Quickchat AI voordat je opslaat.
  1. 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.
  2. 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.
  3. Plak onder Identity → Main Prompt main-prompt.txt uit de kit. Daarmee krijgt de Agent de instructie om de voorgestelde vermelding te tonen en op een aparte bevestiging te wachten.
  4. 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.
ActienaamAPI-eindpuntWat je uit het resultaat gebruikt
lookup_book_isbnhttps://openlibrary.org/search.jsonVul 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_editionhttps://openlibrary.org/isbn/{{isbn}}.jsonControleer 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.

De ISBN-parameter en het Open Library-verzoek in de Action-editor van Quickchat AI. 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.

  1. 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.
  2. 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.

De koppeling met Google Spreadsheets in Quickchat AI en het Google-scherm waarin je een account voor Quickchat AI kiest. Open het bestand dat voor deze Agent is aangemaakt. De starter-Action bevat al de spreadsheet-ID die je nodig hebt.

  1. 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.

Het tabblad Events van Shelf Notes in Google Spreadsheets met de eerste Pride and Prejudice-vermelding en daarnaast het tabblad Status. 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.”

De rij in het leesdagboek, opgesplitst in catalogusvelden, velden van de lezer en de gesprekslink. 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.

  1. 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 vermelding valueInputOption=RAW toe. De modus voor ruwe invoer bewaart ISBN’s en behandelt een notitie die begint met = als tekst.
  2. Stel in Headers Authorization in op Bearer {{google_sheets_access_token}} en Content-Type op application/json. Quickchat AI vult het token tijdens de aanvraag in.
  3. Voeg zes verplichte parameters van het type Text toe met de namen reading_id, isbn, title, edition_url, status en reading_date. Voeg een optionele parameter van het type Text toe met de naam note en een lege standaardwaarde. Kies voor status reading, finished, paused of abandoned. Gebruik voor de datum van de lezer YYYY-MM-DD.
  4. Plak in API Endpoint → Body de JSON hieronder. De twee paar haakjes betekenen één rij met acht cellen. conversation_url is ingebouwd. Plak de append-beschrijving uit de kit in API Action Description.
  5. Maak read_reading_journal als 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 RAW-invoerinstelling van de append-Action en de acht cellen in de JSON-body. 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.

Shelf Notes toont de editie, datum en notitie en vraagt om toestemming om op te slaan. 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

De geslaagde rijtoevoeging door Quickchat AI en de bevestigde leesnotitie in cel G3 van 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.

  1. Plak Status.tsv in 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 status finished is.
  2. 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.
  3. Vraag welke boeken de status finished hebben. In het voorbeeld heeft Status één voltooide leesronde, PAP-01. Geef een tweede leesronde van de roman PAP-02. Zo kun je onderscheiden wat je de eerste keer opviel van wat je de tweede keer opviel.
Op het tabblad Status in Google Spreadsheets verandert de status van reading in finished en stijgt het aantal keren dat een boek is uitgelezen van nul naar één. In een nieuwe chat geeft Shelf Notes de status finished terug.
Status!B2 bevat finished en D2 telt één gelezen boek. Houd Events in toevoegvolgorde, ook voor vermeldingen met een datum in het verleden. Gebruik een filterweergave om erin te bladeren.
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.

Open Library geeft aan dat de editie ontbreekt en Shelf Notes vraagt de lezer het ISBN te controleren. 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.

Quickchat AI Quickchat AI Ask Quickchat AI a question