Pride and Prejudiceを読み終えたとき、あなたは何と書きましたか。この読書記録では、その答えは「I kept noticing who misunderstood whom.」(誰が誰を誤解しているのか、そこについ目がいった)です。これはペンギン版のソフトカバー、ISBN 9780141439518、11月8日に読了した記録です。新しいチャットを開いても、その1文は残っています。
ここでは、Google スプレッドシート上の非公開の読書記録、Shelf Notesを作ります。版の詳細はOpen Libraryが提供し、日付と残したい感想はあなたが入力し、確認後にQuickchat AI Agentがそれらを同じ行にまとめます。
Shelf Notesスターターキットをダウンロードしてください。完成例を見るにはShelf Notes.xlsxを開きます。2つのTSVファイルを使って、Google スプレッドシートで自分の読書記録を作成できます。収録例は1件前の状態から始まり、読者はまだ読み進めている途中です。キットには、Actionの正確な設定とMain Promptも含まれています。
1. 棚にあるのはどの版ですか?
何かを接続する前に、まず検索を試してみましょう。ISBN 9780141439518の版を開いてください。これは、Penguin Booksが2003年に刊行した英語のソフトカバー版で、435ページです。ジェイン・オースティンのこの小説が最初に出版されたのは1813年です。どちらの日付もPride and Prejudiceに関するものですが、机の上のその1冊を表しているのは片方だけです。
- Quickchat AIを開いて、アカウントを作成またはサインインしてください。空のAgentを使うか、Add new AI Agent → Set up manuallyを選びます。名前はShelf Notesにします。読書記録にはGoogleアカウントが必要で、会話を試すには利用可能なAIクレジットも必要です。
- 個人的なメモを追加する前に、Your Website → Install → Availability and accessを開きます。Widget & Embed accessをオフにし、Chat Page AccessをNobodyに設定して、ほかのチャネルは未接続のままにしてください。サインインしたダッシュボードでAI Previewを使います。
- Identity → Main Promptで、キットの
main-prompt.txtを貼り付けます。これにより、Agentは提案する記録を表示し、別の確認を待つようになります。 - Actions & MCPs → Add Action → API Action → Create manuallyで、以下の GET Action を2つ作成します。どちらも When to run → AI decides を使い、What to ask the user first の下に必須の Text パラメータ
isbnを1つ追加し、本文は空のままにします。番号の空白とハイフンは削除し、先頭の 0 と ISBN-10 の末尾のXはそのまま残します。
| Action名 | APIエンドポイント | 結果から使う情報 |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | Query Params に isbn={{isbn}}、fields=key,title,author_name,first_publish_year、limit=1 を入力します。作品データから著者名と小説の初出年を取得します。 |
lookup_edition | https://openlibrary.org/isbn/{{isbn}}.json | 入力した番号が isbn_13 または isbn_10 に含まれていることを確認します。出版社、版の日付、言語があれば読み取ります。返ってきた /books/ キーは、出典リンク用に https://openlibrary.org に付け足します。 |
会話に ISBN を入力します。Action がそれを、エディタでホストを固定した URL に差し込みます。
最初の検索では、作品にひもづく版の一覧もあわせて取得していました。この1つの ISBN に対して、4,042 件の edition ID が返ってきました。この項目を外すと、著者名と初出年だけの短いレスポンスになりました。2つ目のリクエストでは、目的のペーパーバック版1点だけが返りました。
Headersで、各リクエストに User-Agent として ShelfNotes/1.0 (YOUR_CONTACT_EMAIL) を設定し、連絡先の例はご自身のものに置き換えます。action-recipes.md から対応する API Action Description を貼り付け、各 Action を保存して有効化します。「Look up ISBN 978-0-14-143951-8.」 を試してください。読書記録を作成しなくても、その版が表示されるはずです。この個人用の書誌検索に Open Library のアカウントは不要です。本について聞かれたときに使い、Open Library の API 利用ガイドラインに従ってください。
2. 読書記録には何を入れますか?
書誌の事実と自分の観察は、列を分けて管理します。たとえば、このまったく同じ版を誰かに貸しても、登場人物についての感想はすべて食い違うかもしれません。それでも ISBN は同じです。あなたのノートはあなた自身の読書に属するもので、ここでは PAP-01 として識別します。
- Actions & MCPs → Add Action → Google Sheets → Connectを開きます。読書記録を所有する Google アカウントを認証し、Open sheetを選びます。この接続により、
drive.file権限で Drive にスプレッドシートが作成されます。認証画面はGoogle スプレッドシート接続の手順で確認できます。個人用の読書日記なら、Google スプレッドシートで共有を開き、一般的なアクセスは制限付きのままにします。 - 有効になっているスターター Action の
log_lead_to_google_sheetをオフにします。名前はそのまま残し、ファイル ID がすでに入っている API Endpoint をコピーします。スターターはオフのままにしてください。この読書記録用に別の Action を作成します。
この Agent 用に作成されたファイルを開きます。必要なスプレッドシート ID は、スターター Action にすでに入っています。
- Leadsタブの名前をEventsに変更し、内容を A1 から
Events.tsvに置き換えます。貼り付ける前に、列 B(ISBN)と F(日付)をPlain textに設定してください。さらに、Statusという2つ目のタブを追加します。新しい例示用シートでは、下の数式でカンマを使えるように File → Settings → Locale → United States を設定してください。
2行目から始めます。PAP-01はまだ読書中で、G2に“Started with the Netherfield visit.”が入っています。確認すると、完了の記録が3行目に追加されます。
Eventsの8列は、順に reading_id、isbn、title、edition_url、status、reading_date、note、conversation です。最後のセルには会話へ戻るリンクが入ります。スターターの最初のイベントでは、11月2日に reading と記録されています。メモは「Started with the Netherfield visit.」です。
本が reading から finished に変わる間は、同じ読書 ID を使い続けます。再読のためにその本へ戻るときは、新しい ID を選びます。
3. ISBNで読書ノートを保存するには?
検索が答えるのは「どの本か?」です。保存が答えるのは別の問い、「これは覚えておきたい内容か?」です。確認済みの行を追記する Action を 1 つ、スプレッドシートに実際に入っている内容を確認する Action をもう 1 つ設定します。
- API Action を作成し、名前を
append_reading_eventにします。スターターの Sheets URL をコピーし、実際のファイル ID までを残します。残りは/values/Events!A:H:appendに置き換えます。POST を設定し、Query Params にvalueInputOption=RAWを追加します。RAW input モードでは ISBN がそのまま保持され、=で始まるメモはテキストとして扱われます。 - Headers で、
AuthorizationをBearer {{google_sheets_access_token}}に、Content-Typeをapplication/jsonに設定します。Quickchat AI がリクエスト時にトークンを埋め込みます。 - 必須の Text パラメータを 6 つ追加し、名前を
reading_id、isbn、title、edition_url、status、reading_dateにします。任意の Text パラメータとしてnoteを追加し、デフォルトは空欄にします。status にはreading、finished、paused、abandonedのいずれかを使います。日付は読者が記録した日をYYYY-MM-DD形式で使います。 - API Endpoint → Body に、以下の JSON を貼り付けます。2 組の角括弧は、8 つのセルを持つ 1 行を意味します。
conversation_urlは組み込みです。キットの追記用の説明文を API Action Description に貼り付けます。 read_reading_journalを同じスプレッドシートへの GET として作成し、末尾を/values/Events!A2:H1000にします。同じ bearer ヘッダーを設定し、キットの history の説明文を使い、パラメータはなし、body は空にします。両方の Action を保存して有効化します。
{
"values": [[
"{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
"{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
]]
}
この配列は A 列から H 列に対応しています。note を 7 番目に置くと、読者の言葉が G 列に入ります。
スターター行を用意したら、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.
提案された版、ID、日付、句読点を確認します。この時点では、Events にはまだ冒頭の 1 件だけが入っているはずです。そのうえで 「Yes, that is my edition. Save PAP-01 with that status, date and note.」 と送ります。すると 2 件目のイベントが 3 行目に表示されます。
この提案で、ISBN とノートの文面を保存前にもう一度確認できます。読書記録が変わる前なら、どちらも修正できます。
ライブ実行では、提案によって最初の行は変更されませんでした。確認後、Shelf Notesは読書記録を確認し、ISBNを再確認し、1行だけ追加して新しい行を読み返しました。Inboxでappend_reading_eventを展開し、Googleのupdates.updatedRangeをシート内のセルと比べてください。リクエストがタイムアウトしたら、もう一度試す前にその行があるか確認してください。 Google スプレッドシートの行追加に関する資料
GoogleはEvents!A3:H3で1行8セルが更新されたと報告しました。G3を選び、承認したノートと本文を比べてください。
4. 新しい会話では何を聞けますか?
AI Preview で新しい会話を開き、「What was the last note I saved for PAP-01?」と質問します。テストでは、AgentがEventsをもう一度読み、“I kept noticing who misunderstood whom.”を返しました。2 行目には、先ほどの Netherfield のメモがそのまま残っています。Google では、返された行の末尾にある空のセルが省かれることがあるため、スターター行の会話リンクが空欄でも問題ありません。
「Which books am I still reading?」では、1 回の読書に対してイベントが 2 件あると、各行を数えると誤解を招く答えになります。Statusタブを使って、各読書 ID の最後に追記されたイベントを選びます。
Status.tsvをStatus!A1に貼り付けます。A2 の数式で各読書 ID を 1 回ずつ一覧します。B2 では、Eventsのいちばん下から始める完全一致の検索を使います。本棚が増えたら、新しい ID に合わせて B2 を下までコピーしてください。D2 では、最新のステータスがfinishedの ID を数えます。read_reading_statusを作成し、同じ Bearer ヘッダーを使うもう一つのGETを、接尾辞/values/Status!A1:B1000で追加します。キットの status の説明文を貼り付け、body と parameters は空のまま保存して有効化します。- どの本が読み終わっているか尋ねます。サンプルでは、Statusで読了は1件で、
PAP-01です。同じ小説をもう一度読むなら、PAP-02を付けます。すると、1回目に気づいたことと2回目に気づいたことを区別できます。
Google スプレッドシートの数式 3 つをコピーする
Status!A2 には ID が並びます。
=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)
Status!B2 では、A 列の ID に対応する最新のイベントを検索します。
=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))
Status!D2 では、読み終わった読書を数えます。
=COUNTIF(B2:B1000,"finished")
このレシピが扱うのは 999件のイベント です。新しい記録が1000行目より下に入る前に、読み取り範囲と数式の範囲を一緒に広げてください。1回の会話でどれだけ履歴を返すかを決めるときは、長いメモや蔵書が多い場合も考えておきます。Google スプレッドシートの XLOOKUP リファレンス
5. 手元の本でも使えますか?
別の本を1冊手に取り、印刷されているISBNを試してください。どの版かを尋ねたら、そこで止めます。まずは、本を追加せずにその本を確認できることを確かめるのがよい最初のチェックです。次に、その本に読書IDを付け、自分にしか書けない一文を入力します。確認したらチャットを閉じ、新しいチャットでその一文をもう一度返してもらってください。
再現しやすい確認には、Testing → Simulationを使ってから、Actions & MCPs → View logsと保存先のセルを確認してください。認識されないISBNを試し、提案された追加を断り、=1+1で始まるテスト用のメモを保存します。最初の2つでは履歴は変わらないはずです。最後の1つでは、メモのセルにその文字列がそのまま表示されるはずです。
また、ローカルのテスト用シートでは、1行を保存したあと、返信前にタイムアウトするようにもしました。Shelf Notesはその行を読み返し、タイムアウトを報告し、2回目の追記は行いませんでした。保存後にもう一度送信してよいか迷ったときは、Action logでも同じ内容を確認できます。
版が見つからないテストでは、カタログは404を返しました。Agentは別の識別子を求め、読書記録のシートは2行のままでした。
別のアシスタントから Agent を設定したい場合は、このキットに Quickchat AI アカウントコネクタ用の設定リクエストが含まれています。action-recipes.md と main-prompt.txt を添付して、setup-request.txt を渡してください。5つの Action を確認し、Google の認証はご自身で完了してから、同じ読書テストを実行します。ChatGPT コネクタ · Claude コネクタ · アカウント設定ガイド
よくある質問
ISBNでGoogle スプレッドシートに本を追加するには?
お手元の本に印字されたISBNを使って、Open Libraryでその版を調べます。タイトル、出版社、出版年を確認し、読書ステータスとメモを追加してから、その行を確認します。スターターキットには、シートの見出し、数式、Quickchat AIの5つのActionレシピがすべて入っています。
すでにGoogle スプレッドシートで使っている読書記録は使えますか?
Quickchat AI接続で作成したスプレッドシートのEventsタブに、使いたい記録をコピーしてください。8つの列を合わせ、ISBNはテキストのままにします。別の非公開ファイルのIDをActionに貼り付けても、そのファイルを開く権限は付与されません。
Open LibraryでISBNが見つからない場合は?
バーコードか奥付の番号を確認し、先頭の0や末尾のXも含めて見直してください。それでも版を確認できない場合は、読書記録を変更しないでください。ISBNは版を識別するものであり、本の全文へのアクセス権を与えるものではありません。
読み終えた本を数えつつ、再読も記録するには?
読書ごとに専用のIDを付けます。読書を中断したり読み終えたりしてもそのIDは維持し、再読には新しいIDを付けてください。読み終えた項目はStatusタブで数えます。すると、同じ版を2回読み終えた場合は2件として数えられ、1回の読書に対する2回の更新は1件として数えられます。
チャットを閉じたあとでも読書メモは探せますか?
はい。新しい非公開チャットで、その本または読書IDを尋ねてください。履歴ActionがEventsタブをもう一度読み込み、日付付きの記録と元の文言を取得します。Statusタブは、各読書について最後に記録された状態を提供します。