أنشئ سجلّ قراءة في جداول بيانات Google مع البحث برقم ISBN

Piotr Grudzień
تاريخ النشر مدة القراءة: 7 دقائق
صف Pride and Prejudice المكتمل في جداول بيانات Google بجانب رد Quickchat AI الذي يسترجع ملاحظته.

ماذا كتبت عندما أنهيت Pride and Prejudice؟ في سجلّ القراءة هذا، الجواب هو «I kept noticing who misunderstood whom.» (ظللت ألاحظ مَن كان يسيء فهم مَن). وهي تخص إصدار Penguin ذي الغلاف الورقي، برقم ISBN ‏9780141439518، وقد أُنجزت في 8 نوفمبر. وتبقى الجملة هناك عندما تفتح محادثة جديدة.

ستنشئ Shelf Notes، وهو متتبّع قراءة خاص في جداول بيانات Google. يوفّر Open Library تفاصيل الطبعة، وأنت تضيف التاريخ والفكرة التي تريد الاحتفاظ بها، ثم يضعها وكيل Quickchat AI في الصف نفسه بعد التأكيد.

إدخال PAP-01 المكتمل في جداول بيانات Google وملاحظة القارئ نفسها في محادثة جديدة مع Quickchat AI.
تضم علامة التبويب Events إدخالين لـ PAP-01. يحتوي الثاني على ملاحظة 8 نوفمبر. يقرأ Quickchat AI في محادثة جديدة الجدول ويعيد الجملة نفسها.

نزّل الحزمة الابتدائية Shelf Notes. افتح Shelf Notes.xlsx لرؤية المثال المكتمل. استخدم ملفَي TSV لإنشاء سجلّك الخاص في جداول بيانات Google. وهما يبدآن معك بإدخال يسبق هذا الإدخال بواحد، بينما القارئ لا يزال يقرأ. وتحتوي الحزمة أيضًا على إعدادات الإجراء الدقيقة و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 أو سجّل الدخول. استخدم وكيلك الفارغ، أو اختر 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 من الحزمة. وهو يوجّه الوكيل إلى عرض الإدخال المقترح وانتظار تأكيد منفصل.
  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 شاشات التفويض. للحفاظ على خصوصية يومياتك، افتح مشاركة في «جداول بيانات Google» واترك الوصول العام مضبوطًا على حصري.
  2. أوقِف إجراء البداية النشط، وهو log_lead_to_google_sheet. احتفظ باسمه وانسخ API Endpoint الخاص به مع تعبئة معرّف الملف مسبقًا. اترك إجراء البداية متوقفًا. ستنشئ إجراءات منفصلة لهذا السجلّ.

شاشة ربط جداول بيانات Google في Quickchat AI وشاشة Google لاختيار الحساب الذي سيُستخدَم مع Quickchat AI. افتح الملف الذي أُنشئ لهذا الوكيل. يحتوي إجراء البداية مسبقًا على معرّف جدول البيانات الذي تحتاج إليه.

  1. أعِد تسمية علامة التبويب Leads إلى Events، واستبدل محتواها بـ Events.tsv بدءًا من A1. نسّق العمودين B ‏(ISBN) وF ‏(التاريخ) على أنهما Plain text قبل اللصق. أضف علامة تبويب ثانية باسم Status. في ورقة مثال جديدة، استخدم File → Settings → Locale → United States حتى تقبل الصيغ أدناه الفواصل.

علامة التبويب Events في Shelf Notes ضمن جداول بيانات Google، وفيها إدخال Pride and Prejudice الافتتاحي، وبجانبها علامة التبويب Status. ابدأ بالصف 2. ما زال PAP-01 قيد القراءة، وفي G2 عبارة “Started with the Netherfield visit.”. بعد التأكيد، سيظهر إدخال الإنهاء في الصف 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. انسخ عنوان URL الخاص بـ Sheets من إجراء البداية، مع الإبقاء على كل شيء حتى معرّف الملف الفعلي. استبدل الباقي بـ /values/Events!A:H:append. اضبط POST وأضف الإدخال valueInputOption=RAW ضمن Query Params. يحافظ وضع الإدخال الخام على أرقام 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 نفسها، ووصف السجلّ الخاص بالحزمة، ومن دون معلمات وبجسم فارغ. احفظ الإجراءين وفعّلهما معًا.
{
  "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 لإضافة الصفوف

إضافة Quickchat AI الناجحة للصف وملاحظة القراءة المؤكدة في الخلية G3 ضمن جداول بيانات Google. أبلغ 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، باستخدام اللاحقة /values/Status!A1:B1000. الصق وصف الحالة الخاص بالحزمة، واترك المتن والمعاملات فارغة، ثم احفظه وفعّله.
  3. اسأل عن الكتب المنتهية. في المثال، يحتوي Status على قراءة واحدة منتهية هي PAP-01. ولجولة ثانية مع الرواية، امنحها PAP-02. عندها يمكنك التمييز بين ما لاحظته في المرة الأولى وما لاحظته في المرة الثانية.
في علامة التبويب Status في جداول بيانات Google، تتغير الحالة من reading إلى finished، ويرتفع عدد القراءات المكتملة من صفر إلى واحدة. في محادثة جديدة، يعرض Shelf Notes الحالة finished.
تعرض Status!B2 القيمة finished، ويحصي D2 قراءة واحدة. أبقِ Events بترتيب الإضافة، حتى للإدخالات المؤرخة بتاريخ سابق. استخدم عرض تصفية لتصفحه.
انسخ صيغ جداول بيانات Google الثلاث

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

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 باستخدام رقم ISBN؟

استخدم رقم ISBN المطبوع على نسختك للبحث عن طبعتها في Open Library. تحقّق من العنوان والناشر والسنة، ثم أضف حالة القراءة والملاحظة، وبعد ذلك أكّد الصف. تتضمن الحزمة الابتدائية عناوين الأعمدة والصيغ ووصفات الإجراءات الخمس كلها في Quickchat AI.

هل يمكنني استخدام متتبّع قراءة موجود لديّ بالفعل في جداول بيانات Google؟

انسخ الإدخالات التي تريدها إلى علامة التبويب Events في جدول البيانات الذي أنشأه اتصال Quickchat AI. طابِق الأعمدة الثمانية واحتفظ بأرقام ISBN كنص. إن لصق معرّف ملف خاص آخر داخل الإجراء لا يمنحه إذنًا بفتح ذلك الملف.

ماذا لو لم يتمكّن Open Library من العثور على رقم ISBN الخاص بي؟

تحقّق من الرقم الموجود على الرمز الشريطي أو صفحة حقوق الطبع والنشر، بما في ذلك أي صفر بادئ أو X نهائي. إذا تعذّر التحقق من الطبعة مع ذلك، فاترك السجلّ كما هو. يحدّد رقم ISBN طبعةً بعينها، ولا يمنح وصولًا إلى النص الكامل للكتاب.

كيف أحسب الكتب المنتهية وأتابع إعادة القراءة؟

امنح كل قراءة معرّفها الخاص. احتفظ بهذا المعرّف عندما تتوقف عن قراءته أو تنهيه، وامنح إعادة القراءة معرّفًا جديدًا. احسب الإدخالات المنتهية في علامة التبويب Status. عندها تُحتسب قراءتان منتهيتان للطبعة نفسها مرتين، بينما يُحتسب تحديثان لقراءة واحدة مرةً واحدة.

هل يمكنني العثور على ملاحظة قراءة بعد إغلاق المحادثة؟

نعم. اطلب الكتاب أو معرّف القراءة في محادثة خاصة جديدة. يعيد إجراء السجلّ قراءة علامة التبويب Events، حيث تُخزَّن القيود المؤرخة وصياغتك الأصلية. وتوفّر علامة التبويب Status أحدث حالة مسجّلة لكل قراءة.

Quickchat AI Quickchat AI Ask Quickchat AI a question