בנו יומן קריאה ב-Google Sheets עם חיפוש לפי ISBN

Piotr Grudzień
פורסם זמן קריאה: 8 דקות
שורת Pride and Prejudice שהושלמה ב־Google Sheets לצד תשובת Quickchat AI שמזכירה את ההערה שלה.

מה כתבתם כשסיימתם את Pride and Prejudice? ביומן הקריאה הזה, התשובה היא “I kept noticing who misunderstood whom.” (שוב ושוב שמתי לב מי הבין את מי לא נכון.) היא שייכת למהדורת הכריכה הרכה של Penguin, ISBN ‏9780141439518, והקריאה בה הסתיימה ב-8 בנובמבר. המשפט עדיין שם כשתפתחו צ׳אט חדש.

תבנו את Shelf Notes, יומן קריאה פרטי ב-Google Sheets. ‏Open Library מספק את פרטי המהדורה, אתם מספקים את התאריך ואת המחשבה שתרצו לשמור, וסוכן של Quickchat AI מציב אותם באותה שורה אחרי האישור שלכם.

הרשומה PAP-01 שהושלמה ב־Google Sheets וההערה המדויקת של הקורא בצ’אט Quickchat AI חדש.
בלשונית Events יש שתי רשומות ל־PAP-01. השנייה כוללת את ההערה מ־8 בנובמבר. צ’אט Quickchat AI חדש קורא את הגיליון ומחזיר את אותו משפט.

הורידו את ערכת הפתיחה של Shelf Notes. פתחו את Shelf Notes.xlsx כדי לראות את הדוגמה המלאה. השתמשו בשני קובצי ה-TSV כדי לבנות את היומן שלכם ב-Google Sheets. הם מתחילים רשומה אחת קודם, כשהקריאה עדיין בעיצומה. הערכה כוללת גם את הגדרות ה-Action המדויקות ואת Main Prompt.

1. איזו מהדורה נמצאת על המדף שלכם?

נסו את החיפוש לפני שאתם מחברים משהו. פתחו את המהדורה עבור ISBN 9780141439518. זו מהדורת כריכה רכה באנגלית, בת 435 עמודים, שפורסמה על ידי Penguin Books בשנת 2003. הרומן של ג’יין אוסטן הופיע לראשונה ב-1813. שני התאריכים שייכים ל-Pride and Prejudice, אבל רק אחד מהם מתאר את העותק שעל השולחן.

עמוד המהדורה ב־Open Library וההצעה ב־Inbox של Shelf Notes לאותה מהדורת כריכה רכה של Penguin.
מצאו את מהדורת הכריכה הרכה של Penguin ב־Open Library, ואז בדקו את המוציא לאור ואת שנת הפרסום בהצעת Quickchat AI לפני השמירה.
  1. צרו חשבון או התחברו ל־Quickchat AI. השתמשו ב־Agent הריק שלכם, או בחרו ב־Add new AI Agent → Set up manually. תנו לו את השם Shelf Notes. תצטרכו חשבון Google בשביל היומן וקרדיטים זמינים של AI כדי לבדוק שיחה.
  2. לפני שמוסיפים הערות אישיות, פתחו את Your Website → Install → Availability and access. כבו את Widget & Embed access, הגדירו את Chat Page Access ל-Nobody, והשאירו ערוצים אחרים מנותקים. השתמשו ב-AI Preview בלוח הבקרה שלכם כשאתם מחוברים.
  3. תחת Identity → Main Prompt, הדביקו את main-prompt.txt מתוך הערכה. הוא מנחה את ה־Agent להציג את הרשומה המוצעת ולהמתין לאישור נפרד.
  4. ב־Actions & MCPs → Add Action → API Action → Create manually, צרו את שתי פעולות ה־GET שלמטה. בכל אחת מהן השתמשו ב־When to run → AI decides, הוסיפו פרמטר Text נדרש אחד בשם isbn תחת What to ask the user first, והשאירו את גוף הבקשה ריק. הסירו רווחים ומקפים מהמספר, תוך שמירה על אפסים מובילים ועל X סופי ב־ISBN-10.
שם הפעולהנקודת הקצה ב־APIמה להשתמש מהתוצאה
lookup_book_isbnhttps://openlibrary.org/search.jsonב־Query Params, הזינו את isbn={{isbn}}, fields=key,title,author_name,first_publish_year ו־limit=1. היצירה מספקת את שם המחבר/ת ואת השנה המקורית של פרסום הרומן.
lookup_editionhttps://openlibrary.org/isbn/{{isbn}}.jsonבדקו שהמספר שסופק מופיע ב־isbn_13 או ב־isbn_10. קראו את שם ההוצאה, תאריך המהדורה והשפה כשיש אותם. הוסיפו את המפתח /books/ שהוחזר אל https://openlibrary.org כדי ליצור את קישור המקור.

פרמטר ה־ISBN ובקשת Open Library בעורך הפעולות של Quickchat AI. הקלידו את ה־ISBN בשיחה. הפעולה משלבת אותו בכתובת URL שהמארח שלה קבוע בעורך.

בחיפוש הראשון שלנו ביקשנו גם את רשימת המהדורות של היצירה. עבור ה־ISBN הזה חזרו 4,042 מזהי מהדורות. כשהסרנו את השדה הזה, נשארו בתגובה קצרה שם המחבר/ת והשנה המקורית. הבקשה השנייה עדיין החזירה את המהדורה האחת בכריכה רכה שרצינו.

תחת Headers, תנו לכל בקשה User-Agent בערך ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), והחליפו את כתובת הקשר לדוגמה בכתובת שלכם. הדביקו את API Action Description המתאים מתוך action-recipes.md, שמרו והפעילו כל פעולה. נסו את “Look up ISBN 978-0-14-143951-8.”. אתם אמורים לראות את המהדורה בלי ליצור רשומה ביומן. לחיפוש האישי הזה לא צריך חשבון Open Library. השתמשו בו כשמישהו שואל על ספר, ופעלו לפי הנחיות השימוש ב־API של Open Library.

2. מה שייך ליומן הקריאה?

תנו לעובדות הקטלוג ולתצפיות האישיות שלכם עמודות נפרדות. אולי תשאילו למישהי או למישהו את המהדורה המדויקת הזאת ולא תסכימו על אף דמות. ה־ISBN יישאר אותו דבר. ההערה שלכם שייכת לקריאה שלכם, שמזוהה כאן כ־PAP-01.

  1. פתחו את Actions & MCPs → Add Action → Google Sheets → Connect. אשרו את חשבון Google שיהיה הבעלים של היומן, ואז בחרו Open sheet. החיבור יוצר גיליון אלקטרוני ב־Drive תחת הרשאת drive.file שלו. המדריך לחיבור Google Sheets מציג את מסכי האישור. ליומן אישי, פתחו את שיתוף ב-Google Sheets והשאירו את גישה כללית במצב גישה מוגבלת.
  2. כבו את פעולת ההתחלה הפעילה, log_lead_to_google_sheet. השאירו את השם שלה והעתיקו את API Endpoint שלה, כשמזהה הקובץ כבר ממולא. השאירו את פעולת ההתחלה כבויה. תצרו פעולות נפרדות ליומן הקריאה הזה.

החיבור ל־Google Sheets ב־Quickchat AI, ולצדו המסך של Google לבחירת החשבון שישמש את Quickchat AI. פתחו את הקובץ שנוצר עבור ה־Agent הזה. פעולת ההתחלה כבר כוללת את מזהה הגיליון האלקטרוני שאתם צריכים.

  1. שנו את שם הלשונית Leads ל־Events והחליפו את התוכן שלה ב־Events.tsv, החל מ־A1. לפני ההדבקה, עצבו את העמודות B (ISBN) ו־F (תאריך) כ־Plain text. הוסיפו לשונית שנייה בשם Status. בגיליון דוגמה חדש, השתמשו ב־File → Settings → Locale → United States כדי שהנוסחאות שלמטה יקבלו פסיקים.

לשונית Events של Shelf Notes ב־Google Sheets עם רשומת הפתיחה של Pride and Prejudice ולצידה הלשונית Status. התחילו בשורה 2. PAP-01 עדיין בתהליך קריאה, עם “Started with the Netherfield visit.” בתא G2. אחרי שתאשרו, רשומת הסיום תופיע בשורה 3.

שמונה העמודות של Events, לפי הסדר, הן reading_id, isbn, title, edition_url, status, reading_date, note ו־conversation. התא האחרון מכיל קישור חזרה לשיחה. האירוע הראשון של התבנית מציין reading ב־2 בנובמבר. ההערה שלו היא “Started with the Netherfield visit.”

שורת היומן מחולקת לשדות קטלוג, לשדות של הקורא/ת ולקישור לשיחה. השאירו את אותו מזהה קריאה כל עוד ספר עובר מ־reading ל־finished. בחרו מזהה חדש כשאתם חוזרים לספר לקריאה חוזרת.

3. איך שומרים הערת קריאה לפי ISBN?

החיפוש עונה על השאלה “איזה ספר?”. השמירה עונה על שאלה אחרת: “האם זה מה שאני רוצה לזכור?” הגדירו פעולה אחת שמוסיפה את השורה המאושרת ופעולה נוספת שבודקת מה באמת נמצא בגיליון האלקטרוני.

  1. צרו API Action בשם append_reading_event. העתיקו את כתובת ה־Sheets URL של שורת הפתיחה, והשאירו הכול עד מזהה הקובץ האמיתי שלה. החליפו את השאר ב־/values/Events!A:H:append. הגדירו POST והוסיפו את הערך Query Params valueInputOption=RAW. מצב הקלט הגולמי שומר על ערכי ISBN ומתייחס להערה שמתחילה ב־= כאל טקסט.
  2. ב־Headers, הגדירו את Authorization כ־Bearer {{google_sheets_access_token}} ואת Content-Type כ־application/json. Quickchat AI ממלא את האסימון בזמן הבקשה.
  3. הוסיפו שישה פרמטרים נדרשים מסוג Text בשם reading_id, isbn, title, edition_url, status ו־reading_date. הוסיפו פרמטר Text אופציונלי בשם note עם ברירת מחדל ריקה. בחרו ב־reading, finished, paused או abandoned עבור הסטטוס. השתמשו בתאריך של הקורא/ת בפורמט YYYY-MM-DD.
  4. ב־API Endpoint → Body, הדביקו את ה־JSON שלמטה. שתי קבוצות הסוגריים מציינות שורה אחת עם שמונה תאים. conversation_url מובנה כברירת מחדל. הדביקו את תיאור ההוספה של הערכה בתוך API Action Description.
  5. צרו את read_reading_journal בתור GET לאותו גיליון אלקטרוני, עם סיומת /values/Events!A2:H1000. תנו לו את אותה כותרת Bearer, את תיאור ההיסטוריה של הערכה, בלי פרמטרים ועם body ריק. שמרו והפעילו את שתי הפעולות.
{
  "values": [[
    "{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
    "{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
  ]]
}

הגדרת קלט RAW של פעולת ההוספה ושמונת התאים בגוף ה־JSON שלה. המערך תואם לעמודות A עד H. כששומרים את ההערה במקום השביעי, המילים של הקורא או הקוראת נכנסות לעמודה 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.

בדקו את המהדורה המוצעת, המזהה, התאריך וסימני הפיסוק. בשלב הזה Events עדיין אמור להכיל רק את רשומת הפתיחה. אחר כך אמרו “Yes, that is my edition. Save PAP-01 with that status, date and note.”. אירוע שני אמור להופיע בשורה 3.

Shelf Notes מציג את המהדורה, התאריך וההערה ומבקש אישור לשמור. ההצעה נותנת לכן ולכם מבט אחרון על ה-ISBN ועל הניסוח שלכם. אפשר לתקן כל אחד מהם לפני שיומן הקריאה משתנה.

בהרצה החיה שלנו, ההצעה השאירה את שורת הפתיחה ללא שינוי. אחרי האישור, Shelf Notes בדק את היומן, בדק שוב את ה־ISBN, הוסיף שורה פעם אחת וקרא בחזרה את השורה החדשה. ב־Inbox, פתחו את append_reading_event והשוו את updates.updatedRange של Google לתאים בגיליון שלכם. אם בקשה מגיעה לזמן קצוב, חפשו את השורה לפני שתנסו שוב. הפניה להוספת שורה ב־Google Sheets

הוספת השורה המוצלחת של Quickchat AI והערת הקריאה שאושרה בתא G3 ב־Google Sheets. Google דיווח על שורה אחת ושמונה תאים שעודכנו ב־Events!A3:H3. בחרו את 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?”, שני אירועים לקריאה אחת יתנו תשובה מטעה אם סופרים כל שורה. השתמשו בלשונית Status כדי לבחור את האירוע האחרון שנוסף לכל מזהה קריאה.

  1. הדביקו את Status.tsv ב־Status!A1. הנוסחה שלו ב־A2 מציגה כל מזהה קריאה פעם אחת. ‏B2 משתמש בחיפוש של התאמה מדויקת שמתחיל מתחתית Events. מלאו את B2 כלפי מטה לצד מזהים חדשים ככל שהמדף שלכם גדל. ‏D2 סופר מזהים שהסטטוס האחרון שלהם הוא finished.
  2. צרו את read_reading_status, עוד GET עם אותו bearer header, עם הסיומת /values/Status!A1:B1000. הדביקו את תיאור הסטטוס מהערכה, השאירו את ה-body ואת הפרמטרים ריקים, ואז שמרו והפעילו אותו.
  3. שאלו אילו ספרים הסתיימו. בדוגמה, ל-Status יש קריאה אחת שהסתיימה, PAP-01. לקריאה שנייה של הרומן, תנו לה את PAP-02. כך תוכלו להבחין בין מה ששמתם לב אליו בפעם הראשונה לבין מה ששמתם לב אליו בפעם השנייה.
בכרטיסייה Status ב-Google Sheets הסטטוס משתנה מ-reading ל-finished, ומספר הקריאות שהושלמו עולה מאפס לאחת. בשיחה חדשה Shelf Notes מחזיר את הסטטוס finished.
Status!B2 מציג finished ו־D2 סופר קריאה אחת. שמרו על Events לפי סדר ההוספה, גם ברשומות שתוארכו לאחור. השתמשו בתצוגת מסנן כדי לעיין בה.
העתיקו את שלוש הנוסחאות של Google Sheets

Status!A2 מציג את המזהים.

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

Status!B2 מאתר את האירוע שנוסף אחרון עבור המזהה שבעמודה A.

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

Status!D2 סופר קריאות שהסתיימו.

=COUNTIF(B2:B1000,"finished")

המתכון מכסה 999 אירועים. לפני שרשומה חדשה תגיע מתחת לשורה 1000, הרחיבו יחד את טווחי הקריאה ואת טווחי הנוסחאות. כשבוחרים כמה היסטוריה להחזיר בשיחה אחת, קחו בחשבון הערות ארוכות ואוספים גדולים. תיעוד XLOOKUP של Google Sheets

5. האם זה עובד עם הספר שעל השולחן שלכם?

קחו ספר אחר ונסו את ה-ISBN המודפס שלו. בקשו את המהדורה, ואז עצרו. בדיקה ראשונה טובה היא לוודא שאפשר לעיין בספר בלי להוסיף אותו. אחר כך תנו לו מזהה קריאה ומשפט שרק אתם הייתם יכולים לכתוב. אשרו אותו, סגרו את השיחה ובקשו לקבל את המשפט הזה בחזרה.

לבדיקות שאפשר לשחזר, השתמשו ב־Testing → Simulation, ואז בדקו את Actions & MCPs → View logs ואת תאי היעד. נסו ISBN לא מזוהה, דחו רשומה מוצעת, ושמרו הערת בדיקה שמתחילה ב־=1+1. שתי הפעולות הראשונות אמורות להשאיר את ההיסטוריה ללא שינוי. הפעולה האחרונה אמורה להציג את התווים המילוליים בתא ההערה.

גם גרמנו לכך שהגיליון המקומי ישמור שורה ואז יפוג הזמן לפני שישיב. Shelf Notes קרא את השורה בחזרה, דיווח על פקיעת הזמן ולא ביצע הוספה שנייה. אם שמירה אי פעם משאירה אתכם בתהייה אם ללחוץ שוב על שליחה, אפשר לבדוק את אותו פרט גם ביומן הפעולות.

Open Library מחזיר מהדורה שלא נמצאה ו-Shelf Notes מבקש מהקורא או הקוראת לבדוק את ה-ISBN. בבדיקת המהדורה החסרה, הקטלוג החזיר 404. הסוכן ביקש מזהה אחר, ויומן הקריאה נשאר עם שתי השורות שלו.

אם נוח לכם יותר להגדיר את הסוכן מתוך עוזר אחר, הערכה כוללת בקשת הגדרה למחבר החשבון של Quickchat AI. צרפו את action-recipes.md ואת main-prompt.txt, ואז תנו לו את setup-request.txt. עברו על חמש הפעולות, השלימו בעצמכם את ההרשאה של Google והריצו את אותה בדיקת קריאה. חיבור ל-ChatGPT · חיבור ל-Claude · מדריך להגדרת החשבון

שאלות נפוצות

איך מוסיפים ספר ל-Google Sheets לפי ISBN?

השתמשו ב-ISBN שמודפס על העותק שלכם כדי לחפש את המהדורה שלו ב-Open Library. בדקו את הכותרת, המו״ל והשנה, הוסיפו את סטטוס הקריאה וההערה שלכם, ואז אשרו את השורה. ערכת הפתיחה כוללת את כותרות הגיליון, הנוסחאות וכל חמשת מתכוני ה-Action של Quickchat AI.

אפשר להשתמש במעקב קריאה שכבר יש לי ב-Google Sheets?

העתיקו את הרשומות שתרצו אל הלשונית Events בגיליון שנוצר על ידי החיבור של Quickchat AI. התאימו לשמונה העמודות ושמרו את ערכי ה-ISBN כטקסט. הדבקה של מזהה קובץ פרטי אחר לתוך ה-Action לא נותנת לו הרשאה לפתוח את הקובץ הזה.

מה קורה אם Open Library לא מצליח למצוא את ה-ISBN שלי?

בדקו את המספר שמופיע ליד הברקוד או בעמוד זכויות היוצרים, כולל כל אפס מוביל או X סופי. אם עדיין אי אפשר לאמת את המהדורה, השאירו את היומן ללא שינוי. ISBN מזהה מהדורה ואינו מעניק גישה לטקסט המלא של הספר.

איך סופרים ספרים שסיימתי ועוקבים אחרי קריאות חוזרות?

תנו לכל קריאה מזהה משלה. שמרו על המזהה הזה כשאתם עוצרים או מסיימים את הספר, ותנו לקריאה חוזרת מזהה חדש. ספרו רשומות שהושלמו בלשונית Status. כך שתי קריאות שהושלמו של אותה מהדורה ייספרו פעמיים, בעוד ששני עדכונים לאותה קריאה ייספרו פעם אחת.

אפשר למצוא הערת קריאה אחרי שסוגרים את הצ׳אט?

כן. בקשו את הספר או את מזהה הקריאה בצ׳אט פרטי חדש. ה-Action של ההיסטוריה קורא שוב את הלשונית Events, שבה נשמרות הרשומות המתוארכות והניסוח המקורי שלכם. הלשונית Status מספקת את המצב האחרון שנרשם עבור כל קריאה.

Quickchat AI Quickchat AI Ask Quickchat AI a question