Crea un diario di lettura in Fogli Google con ricerca per ISBN

Piotr Grudzień
Pubblicato 8 min di lettura
La riga completata di Pride and Prejudice in Fogli Google accanto alla risposta di Quickchat AI che ricorda la nota.

Che cosa hai scritto quando hai finito Pride and Prejudice? In questo diario di lettura, la risposta è “I kept noticing who misunderstood whom.” (Continuavo a notare chi fraintendeva chi). Appartiene all’edizione Penguin in brossura, ISBN 9780141439518, finita l’8 novembre. La frase è ancora lì quando apri una nuova chat.

Creerai Shelf Notes, un diario di lettura privato in Google Sheets. Open Library fornisce i dettagli dell’edizione, tu aggiungi la data e il pensiero che vuoi conservare, e un Agent di Quickchat AI li inserisce nella stessa riga dopo la tua conferma.

La voce PAP-01 completata in Fogli Google e la nota esatta del lettore in una nuova chat con Quickchat AI.
La scheda Events ha due voci per PAP-01. La seconda contiene la nota dell’8 novembre. In una nuova chat, Quickchat AI legge il foglio e restituisce la stessa frase.

Scarica lo starter kit di Shelf Notes. Apri Shelf Notes.xlsx per vedere l’esempio completo. Usa i due file TSV per creare il tuo diario in Google Sheets. Partono da una voce precedente, quando il lettore sta ancora leggendo. Il kit contiene anche le impostazioni esatte delle Action e il Main Prompt.

1. Quale edizione c’è sul tuo scaffale?

Prova la ricerca prima di collegare qualsiasi cosa. Apri l’edizione per l’ISBN 9780141439518. È un’edizione in brossura in inglese di 435 pagine pubblicata da Penguin Books nel 2003. Il romanzo di Jane Austen è uscito per la prima volta nel 1813. Entrambe le date appartengono a Pride and Prejudice, ma solo una descrive la copia che hai sulla scrivania.

La pagina dell’edizione su Open Library e la proposta nella Inbox di Shelf Notes per la stessa edizione Penguin con copertina flessibile.
Trova l’edizione Penguin con copertina flessibile in Open Library, poi controlla editore e anno nella proposta di Quickchat AI prima di salvare.
  1. Crea un account o accedi a Quickchat AI. Usa il tuo Agent vuoto oppure scegli Add new AI Agent → Set up manually. Chiamalo Shelf Notes. Ti servirà un account Google per il diario e crediti AI disponibili per provare una conversazione.
  2. Prima di aggiungere note personali, apri Your Website → Install → Availability and access. Disattiva Widget & Embed access, imposta Chat Page Access su Nobody e lascia scollegati gli altri canali. Usa AI Preview nella dashboard dopo aver effettuato l’accesso.
  3. In Identity → Main Prompt, incolla main-prompt.txt dal kit. Dice all’Agent di mostrare la voce proposta e di aspettare una conferma separata.
  4. In Actions & MCPs → Add Action → API Action → Create manually, crea le due Actions GET qui sotto. Per ciascuna, usa When to run → AI decides, aggiungi un parametro Text obbligatorio chiamato isbn sotto What to ask the user first e lascia vuoto il body. Rimuovi spazi e trattini dal numero, mantenendo gli zeri iniziali e l’eventuale X finale in un ISBN-10.
Nome dell’azioneEndpoint APICosa usare del risultato
lookup_book_isbnhttps://openlibrary.org/search.jsonIn Query Params, inserisci isbn={{isbn}}, fields=key,title,author_name,first_publish_year e limit=1. L’opera fornisce l’autore e l’anno originale del romanzo.
lookup_editionhttps://openlibrary.org/isbn/{{isbn}}.jsonControlla che il numero fornito compaia in isbn_13 o isbn_10. Leggi editore, data dell’edizione e lingua quando presenti. Aggiungi la chiave /books/ restituita a https://openlibrary.org per ottenere il link alla fonte.

Il parametro ISBN e la richiesta a Open Library nell’editor delle azioni di Quickchat AI. Digita l’ISBN nella conversazione. L’Action lo inserisce in un URL il cui host è fissato nell’editor.

Anche la nostra prima ricerca chiedeva l’elenco delle edizioni dell’opera. Per questo ISBN ha restituito 4,042 ID di edizione. Togliendo quel campo, la risposta è rimasta breve e conteneva l’autore e l’anno originale. La seconda richiesta ha comunque restituito l’unica edizione in brossura che volevamo.

In Headers, assegna a ogni richiesta un User-Agent con valore ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), sostituendo il contatto di esempio con il tuo. Incolla la API Action Description corrispondente da action-recipes.md, poi salva e attiva ogni Action. Prova “Look up ISBN 978-0-14-143951-8.”. Dovresti vedere l’edizione senza creare una voce del diario. Questa ricerca personale non richiede un account Open Library. Usala quando qualcuno chiede informazioni su un libro e segui le linee guida per l’uso dell’API di Open Library.

2. Cosa va nel diario di lettura?

Tieni in colonne separate i dati di catalogo e le tue osservazioni. Potresti prestare a qualcuno questa precisa edizione e non essere d’accordo su nessun personaggio. L’ISBN resta lo stesso. La tua nota appartiene alla tua lettura, qui identificata come PAP-01.

  1. Apri Actions & MCPs → Add Action → Google Sheets → Connect. Autorizza l’account Google che sarà proprietario del diario, poi scegli Open sheet. La connessione crea un foglio di calcolo in Drive con l’autorizzazione drive.file. La guida al collegamento con Fogli Google mostra le schermate di autorizzazione. Per un diario personale, apri Condividi in Fogli Google e lascia Accesso generale su Con limitazioni.
  2. Disattiva l’Action iniziale attiva, log_lead_to_google_sheet. Mantieni il suo nome e copia il suo API Endpoint con l’ID del file già compilato. Lascia disattivata l’Action iniziale. Per questo diario creerai Actions separate.

Il collegamento a Fogli Google in Quickchat AI e la schermata di Google per scegliere l’account da usare con Quickchat AI. Apri il file creato per questo Agent. L’Action iniziale contiene già l’ID del foglio di calcolo che ti serve.

  1. Rinomina il foglio Leads in Events e sostituisci il suo contenuto con Events.tsv, iniziando da A1. Prima di incollare, formatta le colonne B (ISBN) e F (data) come Plain text. Aggiungi un secondo foglio chiamato Status. In un nuovo foglio di esempio, usa File → Settings → Locale → United States così le formule qui sotto accetteranno le virgole.

La scheda Events di Shelf Notes in Fogli Google, con la voce iniziale di Pride and Prejudice e la scheda Status accanto. Parti dalla riga 2. PAP-01 è ancora in lettura, con “Started with the Netherfield visit.” in G2. Dopo la tua conferma, la voce conclusa comparirà nella riga 3.

Le otto colonne di Events, in ordine, sono reading_id, isbn, title, edition_url, status, reading_date, note e conversation. L’ultima cella contiene un link che riporta alla conversazione. Il primo evento dell’Action iniziale riporta reading in data 2 novembre. La sua nota è “Started with the Netherfield visit.”

La riga del diario suddivisa in campi di catalogo, campi del lettore e link alla conversazione. Mantieni un solo ID di lettura mentre un libro passa da reading a finished. Scegline uno nuovo quando torni al libro per una rilettura.

3. Come salvi una nota di lettura tramite ISBN?

La ricerca per ISBN risponde alla domanda “Quale libro?”. Il salvataggio risponde a un’altra domanda: “È questo che voglio ricordare?”. Configura un’Action per aggiungere la riga confermata e un’altra per controllare che cosa contiene davvero il foglio di calcolo.

  1. Crea una API Action chiamata append_reading_event. Copia l’URL di Sheets dell’Action iniziale, mantenendo tutto fino al suo vero ID del file compreso. Sostituisci il resto con /values/Events!A:H:append. Imposta POST e aggiungi in Query Params la voce valueInputOption=RAW. La modalità di input RAW preserva gli ISBN e tratta come testo una nota che inizia con =.
  2. In Headers, imposta Authorization su Bearer {{google_sheets_access_token}} e Content-Type su application/json. Quickchat AI inserisce il token al momento della richiesta.
  3. Aggiungi sei parametri Text obbligatori chiamati reading_id, isbn, title, edition_url, status e reading_date. Aggiungi un parametro Text facoltativo chiamato note con valore predefinito vuoto. Per lo stato scegli reading, finished, paused oppure abandoned. Per la data usa quella del lettore, in formato YYYY-MM-DD.
  4. In API Endpoint → Body, incolla il JSON qui sotto. Le due coppie di parentesi quadre indicano una riga con otto celle. conversation_url è integrato. Incolla la descrizione di append del kit in API Action Description.
  5. Crea read_reading_journal come GET verso lo stesso foglio di calcolo, con finale /values/Events!A2:H1000. Assegnagli lo stesso header Bearer, la descrizione della cronologia del kit, nessun parametro e un body vuoto. Salva e abilita entrambe le Actions.
{
  "values": [[
    "{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
    "{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
  ]]
}

L'impostazione di input RAW dell'Action di append e le otto celle nel suo body JSON. L’array corrisponde alle colonne da A a H. Tenendo la nota in settima posizione, le parole del lettore finiscono nella colonna G.

Con la riga iniziale già inserita, invia il seguente messaggio 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.

Controlla l’edizione proposta, l’ID, la data e la punteggiatura. A questo punto Events dovrebbe ancora contenere solo la voce iniziale. Poi di’ “Yes, that is my edition. Save PAP-01 with that status, date and note.”. Un secondo evento dovrebbe comparire alla riga 3.

Shelf Notes mostra l'edizione, la data e la nota e chiede il permesso di salvare. La proposta ti dà un’ultima occasione per controllare l’ISBN e la formulazione. Puoi correggere entrambi prima che il diario cambi.

Nel nostro test dal vivo, la proposta ha lasciato intatta la riga iniziale. Dopo la conferma, Shelf Notes ha controllato il diario, verificato di nuovo l’ISBN, aggiunto una sola riga e riletto la nuova riga. In Inbox, espandi append_reading_event e confronta updates.updatedRange di Google con le celle del tuo foglio. Se una richiesta va in timeout, cerca la riga prima di riprovare. Riferimento di Google Sheets per aggiungere righe

L’aggiunta riuscita in Quickchat AI e la nota di lettura confermata nella cella G3 di Fogli Google. Google ha segnalato una riga e otto celle aggiornate in Events!A3:H3. Seleziona G3 per confrontare il testo con la nota che hai approvato.

4. Cosa puoi chiedere in una nuova chat?

Apri una nuova chat in AI Preview e chiedi “What was the last note I saved for PAP-01?”. Nel nostro test, l’Agent ha letto di nuovo Events e ha restituito “I kept noticing who misunderstood whom.” La riga 2 contiene ancora la nota precedente su Netherfield. Google può omettere le celle vuote alla fine di una riga restituita, quindi è normale che nella riga iniziale il link della conversazione sia vuoto.

Per “Which books am I still reading?”, due eventi per una sola lettura darebbero una risposta fuorviante se contassi ogni riga. Usa la scheda Status per selezionare l’ultimo evento aggiunto per ogni ID di lettura.

  1. Incolla Status.tsv in Status!A1. La formula in A2 elenca ogni ID di lettura una sola volta. B2 usa una ricerca a corrispondenza esatta che parte dal fondo di Events. Estendi B2 verso il basso accanto ai nuovi ID man mano che il tuo scaffale cresce. D2 conta gli ID il cui stato più recente è finished.
  2. Crea read_reading_status, un’altra GET con la stessa intestazione bearer, usando il suffisso /values/Status!A1:B1000. Incolla la descrizione dello stato del kit, lascia vuoti body e parametri, poi salva e abilitala.
  3. Chiedi quali libri hai finito. Nell’esempio, Status ha una lettura conclusa, PAP-01. Per una seconda lettura dello stesso romanzo, assegnale PAP-02. Così puoi distinguere ciò che hai notato la prima volta da ciò che hai notato la seconda.
Nella scheda Status di Fogli Google lo stato passa da reading a finished e il conteggio delle letture concluse sale da zero a una. In una nuova chat, Shelf Notes restituisce finished.
Status!B2 mostra finished e D2 conta una lettura. Mantieni Events in ordine di aggiunta, anche per le voci retrodatate. Usa una visualizzazione filtro per sfogliarlo.
Copia le tre formule di Fogli Google

Status!A2 elenca gli ID.

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

Status!B2 recupera l’evento più recente per l’ID nella colonna A.

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

Status!D2 conta le letture concluse.

=COUNTIF(B2:B1000,"finished")

La procedura copre 999 eventi. Prima che una nuova voce finisca sotto la riga 1000, estendi insieme gli intervalli di lettura e quelli delle formule. Quando scegli quanta cronologia restituire in una conversazione, tieni presenti note lunghe e raccolte ampie. Guida a XLOOKUP in Fogli Google

5. Funziona con il libro che hai sulla scrivania?

Prendi un altro libro e prova il suo ISBN stampato. Chiedi l’edizione, poi fermati. Un buon primo controllo è verificare che tu possa consultare un libro senza aggiungerlo. Poi assegnagli un ID di lettura e una frase che solo tu potresti aver scritto. Confermala, chiudi la chat e chiedi che ti venga restituita quella frase.

Per fare controlli ripetibili, usa Testing → Simulation, poi controlla Actions & MCPs → View logs e le celle di destinazione. Prova un ISBN non riconosciuto, rifiuta una voce proposta e salva una nota di prova che inizi con =1+1. I primi due casi non devono modificare lo storico. Nell’ultimo, la cella della nota deve mostrare i caratteri letterali.

Abbiamo anche fatto in modo che il foglio locale salvasse una riga e poi andasse in timeout prima di rispondere. Shelf Notes ha riletto quella riga, ha segnalato il timeout e non ha fatto un secondo inserimento. Se dopo un salvataggio ti chiedi se premere di nuovo invio, puoi verificare lo stesso dettaglio nel log dell’Action.

Open Library restituisce un'edizione non trovata e Shelf Notes chiede al lettore di controllare l'ISBN. Nel test dell’edizione non trovata, il catalogo ha restituito 404. L’Agent ha chiesto un altro identificatore e il diario è rimasto con le sue due righe.

Se preferisci configurare l’Agent da un altro assistente, il kit include una richiesta di configurazione per il connettore dell’account Quickchat AI. Allega action-recipes.md e main-prompt.txt, poi passagli setup-request.txt. Controlla le cinque Actions, completa tu stesso l’autorizzazione di Google ed esegui lo stesso test di lettura. Connettore ChatGPT · Connettore Claude · Guida alla configurazione dell’account

Domande frequenti

Come aggiungo un libro a Google Sheets con un ISBN?

Usa l’ISBN stampato sulla tua copia per cercare la sua edizione su Open Library. Controlla titolo, editore e anno, aggiungi il tuo stato di lettura e la nota, poi conferma la riga. Lo starter kit include le intestazioni del foglio, le formule e tutte e cinque le ricette Action di Quickchat AI.

Posso usare un diario di lettura che ho già in Google Sheets?

Copia le voci che vuoi nella scheda Events del foglio di calcolo creato dalla connessione Quickchat AI. Fai combaciare le otto colonne e mantieni gli ISBN come testo. Incollare nell’Action l’ID di un altro file privato non le dà il permesso di aprire quel file.

E se Open Library non trova il mio ISBN?

Controlla il numero sul codice a barre o sulla pagina del copyright, compreso l’eventuale zero iniziale o la X finale. Se l’edizione ancora non può essere verificata, lascia il diario invariato. Un ISBN identifica un’edizione e non dà accesso al testo completo del libro.

Come conto i libri finiti e tengo traccia delle riletture?

Assegna a ogni lettura il suo ID di lettura. Mantieni quell’ID quando interrompi o finisci il libro, e assegna un nuovo ID a una rilettura. Conta le voci completate nella scheda Status. Così due letture concluse della stessa edizione contano due volte, mentre due aggiornamenti della stessa lettura contano una volta sola.

Posso ritrovare una nota di lettura dopo aver chiuso la chat?

Sì. In una nuova chat privata chiedi del libro o dell’ID di lettura. L’Action della cronologia legge di nuovo la scheda Events, dove sono salvate le voci datate e il testo originale che hai scritto. La scheda Status fornisce lo stato registrato più di recente per ogni lettura.

Quickchat AI Quickchat AI Ask Quickchat AI a question