البيانات المنظَّمة للإجراءات المتعلقة بالكتب (Book
)
من خلال الإجراءات المتعلقة بالكتب، يصبح "بحث Google" مساحة لاكتشاف الكتب والمؤلفين. ويتيح ذلك لمستخدمي "بحث Google" شراء أو استعارة الكتب التي يعثرون عليها مباشرةً وبسرعة من نتائج البحث.
على سبيل المثال، يمكن للمستخدم البحث عن كتاب Charlotte's Web، وسيتم عرض النتائج التي
تسمح له بشراء الكتاب أو استعارته. بصفتك موفّرًا للكتب، يمكنك تقديم خلاصة بيانات إلى Google باستخدام مخطط البيانات المنظَّمة المقدَّم هنا.
وتوفّر مواصفاتنا
السمة ReadAction
للسماح للمستخدمين بشراء كتاب والسمة BorrowAction
للسماح لهم باستعارة
كتاب.
![إجراء متعلّق بالكتب في نتائج "بحث Google"](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/books01.png?authuser=9&hl=ar)
تعرض إجراءات القراءة وإجراءات الاستعارة خيارات لشراء الكتاب أو استعارته، وهي مدمَجة في اللوحات. ومن خلال الروابط التي توفّرها، تنقل إجراءات القراءة وإجراءات الاستعارة المستخدمين مباشرةً من بطاقة المعلومات وغيرها من مساحات عرض Google إلى صفحة الكتاب على موقعك الإلكتروني أو في تطبيقك.
يتم عرض موفّري الكتب في بطاقة المعلومات بترتيب مخصّص وديناميكي يستند إلى كل مستخدم. ويعني ذلك أنّ المستخدمين المختلفين يرون ترتيبات مختلفة، وقد تُعرض للمستخدم نفسه ترتيبات مختلفة في أوقات مختلفة. ويتأثر كل ترتيب بمجموعة متنوعة من العوامل. على سبيل المثال، إذا نقر المستخدم على رابط موفّر معيّن في بطاقة المعلومات بشكل متكرّر، من المرجّح أن يتم عرض هذا الموفّر في موضع أعلى في الترتيب. وليست هناك طريقة للتحكّم في الترتيب.
البدء
لتنفيذ الإجراءات المتعلقة بالكتب بنجاح، عليك إنشاء خلاصتك وفقًا لتعريفات أنواع البيانات المنظَّمة الخاصة بإجراءات الكتب، ولكن عليك أولاً مراجعة الأقسام التالية:
- الإرشادات
- إنشاء الخلاصة
- اختبار خلاصتك باستخدام أداة التحقق من خلاصة البيانات
- استضافة ملف الخلاصة
- إرسال ملف الخلاصة للمراجعة
- تعديل الخلاصة حسب الحاجة
الإرشادات
لضمان إمكانية عرض كتبك في "بحث Google"، من الضروري أن تطّلع على بعض التفاصيل المهمة والمفاهيم الرئيسية. بالإضافة إلى ذلك، يجب أن تستوفي خلاصتك بعض المواصفات الموحّدة للتنسيقات.
لمساعدتك في تنفيذ ذلك، اتّبِع الإرشادات الموضّحة هنا، بالإضافة إلى الإرشادات العامة للبيانات المنظَّمة وأساسيات "بحث Google". إليك الإرشادات:
الأعمال والإصدارات
في هذه المستندات، نستخدم عبارتَين مختلفتَين عندما نتحدث عن كتاب:
- العمل: هو المفهوم المجرّد للكتاب. على وجه التحديد، تتكوّن سمات العمل من بيانات وصفية مثل العنوان والمؤلف واللغة الأصلية.
- الإصدار: هو نسخة مادية من الكتاب. على وجه التحديد، تتكوّن سمات الإصدار من بيانات وصفية مثل سنة النشر واسم الإصدار ورقم الكتاب المعياري الدولي (ISBN).
على سبيل المثال، Charlotte's Web هو عمل، ولكن كل طبعة مختلفة منه تسمى إصدارًا. في هذه الحالة، قد يشتمل العمل Charlotte's Web على إصدار أول وإصدار ثانٍ وإصدار مختصر وإصدار بترجمة فرنسية وما إلى ذلك.
يُعتبر هذا الفرق مهمًا في الخلاصة للغاية، لأنّه قد لا يكون واضحًا على الفور. ثمة كيانان لسمة Book
:
Book
(Work
) هي نوع الكيان ذو "المستوى الأعلى" في السمةBook
:workExample
هي سمة منWork
تحدّد حالة واحدة فقط منBook
(Edition
).- يجب إدراج سمة
workExample
واحدة على الأقل لكلWork
.
Book
(Edition
) هي نوع الكيان ذو "المستوى الأدنى" في السمةBook
.
من المفيد الانتباه إلى أنّ العمل الواحد قد يتضمّن عدة إصدارات. وننصحك بتجميع هذه الإصدارات معًا قدر الإمكان. ويساعد هذا الإجراء أنظمة Google في الاستفادة من جميع المعلومات ذات الصلة بكتاب معيّن وعرضها في "بحث Google". وعند الضرورة، يمكنك تقسيم الإصدارات إلى عدّة سجلّات عمل، ولكن يجب أن يتضمّن كل سجلّ عمل ما يلي:
- سمة
@id
مختلفة - إصدار واحد على الأقل يحمل رقم ISBN أو معرّف آخر متوافق
أنظمة المكتبة وأعضاء المكتبة
السمة Library entity
هي نوع الكيان ذو "المستوى الأعلى" في السمة Library
. وهو عبارة عن بنية مجرّدة تتكوّن من كيان في السمة LibrarySystem
وكل كيانات "المستوى الأدنى" في السمة Library (member)
لنظام المكتبة هذا.
الكيان LibrarySystem
هو فكرة مجرّدة ويمثّل شبكة مشتركة من أعضاء المكتبة. على سبيل المثال، يمكن تحديد مكتبة أوستن العامة ككيان LibrarySystem
. يعرّف الموقع الإلكتروني لمكتبة أوستن العامة عن المكتبة بصفتها نظام مكتبة عامة في مدينة أوستن في ولاية تكساس. وتتكوّن من 20 مكتبة تابعة أو أعضاء في المكتبة.
يتطلب كل كيان LibrarySystem
كيان Library (member)
واحدًا على الأقل، حتى إذا لم تكن المكتبة في الواقع جزءًا من أي نظام مكتبة. في هذا السيناريو، وبهدف تنفيذ إجراء الكتاب، تُعتبر المكتبة عضو المكتبة الوحيد في نظام المكتبة الخاص بها. وبهدف تنفيذ الإجراء المتعلّق بالكتاب، على عكس نظام المكتبة، لا يتم اعتبار عضو المكتبة فكرة مجرّدة،
وبالتالي لديه عنوان جغرافي.
في المقابل، يجب أن ينتمي كل كيان Library (member)
إلى كيان LibrarySystem
واحد على الأقل.
رقم ISBN والمعرّفات الأخرى المتوافقة
رقم ISBN هو إشارة التوافق الرئيسية عندما يطابق "بحث Google" بيانات خلاصتك مع بيانات Google. ويجب تقديم رقم ISBN أو معرّف آخر متوافق لجميع الكتب التي تريد عرضها في نتائج "بحث Google". وبدون المعرّف، لن تتم مطابقة الكتب على الأرجح وبالتالي لن يتم عرضها.
من المفضّل إدراج رقم ISBN مكوّن من 13 رقمًا في "بحث Google"، ولكن يمكنك بدلاً من ذلك توفير ما يلي:
- رقم مركز المكتبة الرقمية على الإنترنت (OCLC)
- رقم الضبط في مكتبة الكونغرس (LCCN)
- الرمز الإلكتروني JP
الروابط
لضمان حصول المستخدمين على أفضل تجربة للعثور على كتبك، يجب أن تتوافق الروابط في خلاصتك مع الإرشادات التالية:
- إذا كانت لديك صفحات مكرّرة للمحتوى نفسه، يجب أن يكون الرابط عنوان URL الأساسي الذي يحتوي على عنوان الكتاب ومعلومات الكتاب الأخرى.
- بعد أن ينقر المستخدم على رابط أحد إجراءات القراءة أو الاستعارة، يجب أن يتم توجيهه إلى الصفحة التي تتيح له مباشرةً شراء الكتاب أو استعارته. وتحديدًا، يجب ألّا توجّه روابط الإجراءات إلى صفحات تتضمن مزيدًا من الروابط التي يجب النقر عليها لشراء المحتوى أو استعارته. على سبيل المثال، لا توجّه المستخدمين إلى صفحة نتائج بحث أو صفحة ملخّص لمنتج.
إنشاء الخلاصة
إذا كان موقعك الإلكتروني يتيح للمستخدمين شراء الكتب، يجب تحميل خلاصة Book
. تواصَل مع ممثل عن Google وتحقق من التفاصيل المرتبطة بكيفية تحميل الخلاصة ومكان تحميلها.
إذا كان موقعك الإلكتروني يتيح للمستخدمين استعارة الكتب، يجب تحميل خلاصتَين منفصلتَين: خلاصة Book
وخلاصة Library
. تواصَل مع ممثل عن Google وتحقق من التفاصيل المرتبطة بكيفية تحميل الخلاصة ومكان تحميلها.
الالتزام بمتطلبات حجم ملف الخلاصة وتنسيقه وعدد الملفات
المتطلبات هي التالية:
- متطلبات حجم ملف الخلاصة:
- يجب أن يكون حجم ملف الخلاصة غير المضغوط أقل من 1 غيغابايت.
- يجب ألا يزيد حجم ملف الخلاصة الذي سيتم ضغطه عن 1 غيغابايت. إذا تجاوز حجم ملف الخلاصة غير المضغوط 1 غيغابايت، يجب تقسيم ملف الخلاصة غير المضغوط إلى عدّة ملفات.
- يمكنك ضغط ملفات الخلاصة. ويجب تنسيق الملف على شكل ملف أرشيف بصيغة zip أو gz أو tar أو tar.gz أو JAR أو ar أو arj أو cpio أو dump.
- إذا كانت لديك عدّة ملفات للخلاصة، يمكنك تحميلها كما هي، أو يمكنك تضمينها كجزء من ملف فهرسة Sitemap إذا كنت تفضّل ذلك.
- يجب أن تتضمّن ملفات الخلاصة الفردية الإضافة
.json
في اسم الملف.
الالتزام بمتطلبات محتوى الخلاصة
الالتزام بشكل خاص بمتطلبات محتوى الخلاصة التالية التي يجب التقيّد بها:
- يجب ألا تتضمّن الخلاصة كيانات قديمة. الكيانات القديمة هي كيانات تم ضبط السمة
availabilityEnds
فيها على تاريخ في الماضي أو كيانات لم تعُد متاحة على موقعك الإلكتروني. - إنّ كل الروابط لصفحات معيّنة، مثل
urlTemplate
، وجميع عناوين URL، مثلurl
التي تُدرجها في خلاصتك يجب أن تكون عناوين URL إنتاجية. ولا تستخدم عناوين تأكيد الجودة أو التطوير أو أي نوع آخر من عناوين URL غير الإنتاجية. - يجب أن تكون جميع عناوين URL، مثل
url
، عناوين أساسية. - يجب أن يحدّد كل كيان في خلاصتك الخصائص التالية:
- معرّف فريد:
@id
- عنوان URL فريد:
url
- رابط لصفحة معيّنة فريدة:
urlTemplate
- معرّف فريد:
اختبار الخلاصة باستخدام أداة التحقق من خلاصة البيانات
ننصحك باتّباع الخطوات التالية لتحديد المشاكل وحلّها بهدف معالجة الأخطاء والتحذيرات الشائعة في أداة التحقق من خلاصة البيانات:
-
تأكّد من تحديد الخيار الصحيح في الحقل التحقق من الصحة على. اختَر إجراءات الكتب للكيان
Book
. - تأكّد من كتابة قيمة
@type
بشكل صحيح. - تأكّد من ضبط قيمة
@context
بشكل صحيح. اضبط"@context": "https://schema.org"
في كل منReadAction
وBorrowAction
.
استضافة ملف الخلاصة
عندما يصبح ملف الخلاصة جاهزًا، يمكنك استضافته في موقع آمن. تجلب Google الخلاصة بشكل دوري للتأكّد من عرض أحدث محتوى خاص بك.
طرق الاستضافة
تتوفّر الطرق التالية لاستضافة الخلاصات:
الاستضافة | خدمة المصادقة | |
---|---|---|
Google Cloud Storage | إذن عارض عنصر التخزين | |
HTTPS | اسم المستخدم وكلمة المرور أو شهادات HTTP الخاصة بالعميل | |
بروتوكول SFTP | كلمة المرور أو المفتاح والعبارة أو كلاهما | |
AWS S3 | معرّف المفتاح ومفتاح الوصول |
إرسال ملف الخلاصة للمراجعة
لكي يكون المحتوى الخاص بك متاحًا في "بحث Google"، يراجع فريق دعم Google جودة الروابط الخاصة بمواضع معيّنة في خلاصتك. ونشدّد على أهمية اختبار بعض الروابط الخاصة بمواضع معيّنة في التطبيق للتأكّد من أنّها تفتح الصفحة حيث يمكن للمستخدمين شراء أو استعارة الكتب.
لطلب مراجعة خلاصتك، يُرجى تقديم ما يلي:
- موقع المضيف: عنوان URL لملف الخلاصة.
- مصادقة المضيف إذا توفّرت: بيانات اعتماد المصادقة للسماح لمحرّك البحث Google بالحصول على ملف الخلاصة من موقع المضيف.
تعديل الخلاصة حسب الحاجة
ننصحك بتعديل خلاصتك يوميًا، ولكن هذا يعتمد بشكل أساسي على عدد مرات تغيير الكتالوج. ويُرجى الانتباه إلى الشروط والملاحظات التالية:
- لا يتيح محرّك بحث Google إمكانية تعديل المحتوى في الوقت الفعلي.
- يجلب محرّك بحث Google خلاصتك مرة واحدة في اليوم ويفهرس المحتوى في غضون يومين عادةً.
- إذا كان من المتوقّع حصول تغيير في مدى توفّر أحد الإصدارات، استخدِم
availabilityStarts
وavailabilityEnds
لضبط التواريخ الدقيقة. إذا لم يعُد الكيان متاحًا، يمكنك إزالته تمامًا.
تعريفات أنواع البيانات المنظَّمة
يجب تضمين السمات المطلوبة المدرَجة هنا حتى يصبح المحتوى مؤهّلاً للعرض في نتائج البحث المنظَّمة. ويمكنك تضمين السمات المقترَحة لإضافة المزيد من المعلومات المتعلقة بالمحتوى، ما يؤدي إلى تحسين تجربة المستخدم.
كيان DataFeed
يجب أن يتضمن كل ملف خلاصة بيانات على schema.org يتم تسليمه إلى Google كيانًا واحدًا من DataFeed
في مستوى الجذر. يجب إدراج جميع كيانات
Book
وLibrary
ضمن
الحقل dataFeedElement
في الكيان DataFeed
.
في ما يلي السمات المتوافقة مع Google:
السمات المطلوبة | |
---|---|
@context |
اضبط النوع على |
@type |
اضبط النوع على |
dataFeedElement |
اضبط السمة إما على الكيان مثال على الاستخدام في خلاصة { "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "Book", "@id": "https://example.com/work/the_catcher_in_the_rye", "url": "https://example.com/work/the_catcher_in_the_rye", "name": "The Catcher in the Rye", "author": { "@type": "Person", "name": "J.D. Salinger" }, "sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye", "workExample": [ { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_paperback", "isbn": "9787543321724", "bookEdition": "Mass Market Paperback", "bookFormat": "https://schema.org/Paperback", "inLanguage": "en", ... }, ... ] } ], "dateModified": "2018-09-10T13:58:26.892Z" } مثال على الاستخدام في خلاصة { "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "LibrarySystem", "@id": "https://example.com/library-systems/100", "name": "Santa Clara County Library District", "additionalProperty": [ { "@type": "PropertyValue", "name": "librarytype", "value": "public" } ], ... }, ... ], "dateModified": "2018-09-10T13:58:26.892Z" } |
dateModified |
تمثّل هذه الخاصية تاريخ ووقت آخر تعديل أُجري على الخلاصة بتنسيق ISO 8601. |
كيان Book
يتوفّر تعريف Book
الكامل على schema.org/Book، ولكن يجب مراعاة الخصائص التالية فقط. يجب تحديد السمات المطلوبة لكل كتاب تختار تضمينه في خلاصتك. ويمكنك تحديد السمات المقترَحة لإضافة المزيد من المعلومات المتعلقة بالمحتوى، ما يؤدي إلى تحسين تجربة المستخدم.
Book
(Work
)
كيان Book
هذا هو نوع الكيان ذو المستوى الأعلى. وهو يمثّل العمل.
في ما يلي السمات المتوافقة مع Google:
السمات المطلوبة | |
---|---|
@context |
اضبط النوع على |
@id |
تمثّل هذه السمة معرّفًا فريدًا عالميًا للكتاب بتنسيق عنوان URL. ويجب أن يكون فريدًا لمؤسستك. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. وننصحك باستخدام تنسيق عنوان URL
ولكن ذلك ليس إلزاميًا. ولا يُشترط أن يكون رابطًا منشورًا. ويجب أن يكون النطاق المستخدَم للقيمة |
@type |
اضبط النوع على |
author |
تمثّل هذه السمة مؤلّفي الكتاب. |
name |
تمثّل هذه السمة عنوان الكتاب. |
url |
تمثّل هذه السمة عنوان URL على الموقع الإلكتروني الذي يتضمن وصفًا أو معلومات عن الكتاب. ويساعد هذا الرابط
في التوفيق بدقة بين المحتوى في خلاصتك والمحتوى في قواعد بيانات Google. ويمكن أن يتطابق الرابط مع بالنسبة إلى الصفحة المقصودة، تستخدم خدمة "بحث Google" عنوان URL المقدَّم في |
workExample |
تمثّل هذه السمة إصدارات العمل. |
السمات المقترَحة | |
---|---|
sameAs |
تمثّل هذه السمة عنوان URL لصفحة مرجعية تشير إلى نوع العمل. على سبيل المثال، الصفحة الخاصة بالكتاب في ويكيبيديا أو Wikidata أو VIAF أو مكتبة الكونغرس. |
Book
(Edition
)
تستخدم السمة workExample
الوحدة Book
هذه. وتمثّل إصدارًا من العمل.
في ما يلي السمات المتوافقة مع Google:
السمات المطلوبة | |
---|---|
@id |
تمثّل هذه السمة معرّفًا فريدًا عالميًا للكتاب بتنسيق عنوان URL. ويجب أن يكون فريدًا لمؤسستك. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. وننصحك باستخدام تنسيق عنوان URL
ولكن ذلك ليس إلزاميًا. ولا يُشترط أن يكون رابطًا منشورًا. ويجب أن يكون النطاق المستخدَم للقيمة |
@type |
اضبط النوع على |
bookFormat |
تمثّل هذه السمة تنسيق الإصدار. ويجب أن تكون قيمة من إحدى القيم التالية:
|
inLanguage |
تمثّل هذه السمة اللغة الرئيسية للمحتوى في الإصدار. استخدِم أحد الرموز المكوَّنة من حرفَين من قائمة رموز ISO 639-1 alpha-2. |
isbn |
تمثّل هذه السمة رقم ISBN المكوّن من 13 رقمًا للإصدار. إذا كان لديك رقم ISBN مكوّن من 10 أرقام، عليك تحويله إلى رقم ISBN مكوّن من 13 رقمًا. |
potentialAction |
تمثّل هذه الخاصية الإجراء الذي سيتم تشغيله للمستخدمين عند شراء الكتاب أو تنزيله. لمزيد من التفاصيل، راجِع |
السمات المقترَحة | |
---|---|
author |
تمثّل هذه السمة مؤلّفي الإصدار. |
bookEdition |
تمثّل هذه السمة معلومات عن إصدار الكتاب. مثلاً: |
datePublished |
تاريخ نشر الإصدار بتنسيق YYYY-MM-DD أو YYYY: وقد يكون إما تاريخًا محددًا أو سنة معيّنة. |
identifier |
تمثّل هذه الخاصية المعرّف الخارجي أو المعرّف الآخر الذي يعرّف هذا الإصدار بوضوح. ويُسمح باستخدام عدّة معرّفات. لمزيد من التفاصيل، راجِع
يمكن تكرار هذه السمة. |
name |
تمثّل هذه السمة عنوان الإصدار. وتُستخدم هذه السمة فقط إذا كان عنوان الإصدار مختلفًا عن عنوان العمل. |
sameAs |
تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية تشير بوضوح إلى الإصدار. على سبيل المثال، صفحة ويكيبيديا لهذا الإصدار تحديدًا. ويجب عدم إعادة استخدام
|
url |
تمثّل هذه السمة عنوان URL لموقعك الإلكتروني الذي يتضمن وصفًا أو معلومات عن الإصدار. ويمكن أن يتطابق العنوان مع |
مثال على Book
(Edition
):
"workExample": { "@type": "Book", "@id": "https://example.com/book/100", "inLanguage": "en", "isbn": "9787543321724", "bookEdition": "20 Anniversary Edition", "datePublished": "2000-02-26", "bookFormat": "https://schema.org/Hardcover", "potentialAction": {...} }
مثال على Book
(Edition
) مع عدة خصائص workExample
:
"workExample": [ { "@type": "Book", "@id": "https://example.com/book/200", "inLanguage": "zh", "isbn": "9787543321721", "bookEdition": "2nd Edition", "bookFormat": "https://schema.org/Hardcover", "potentialAction": {...} }, { "@type": "Book", "@id": "https://example.com/book/300", "inLanguage": "zh", "isbn": "9787543321722", "bookEdition": "1st Edition", "bookFormat": "https://schema.org/EBook", "potentialAction": {...} } ]
Person
أو Organization
(author
)
تستخدم السمة author
للكتاب الوحدة Person
أو Organization
.
السمات المطلوبة | |
---|---|
@type |
اضبط النوع على |
name |
تمثّل هذه السمة اسم الشخص أو المؤسسة. |
السمات المقترَحة | |
---|---|
sameAs |
تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية تشير بوضوح إلى هوية الشخص أو المؤسسة. على سبيل المثال، صفحة ويكيبيديا للشخص أو المؤسسة. |
مثال على سمة author
:
"author": { "@type": "Person", "name": "William Shakespeare" }
مثال مع خصائص author
متعدّدة:
"author": [ { "@type": "Person", "name": "William Shakespeare" }, { "@type": "Person", "name": "Victor Hugo", "sameAs": "https://en.wikipedia.org/wiki/Victor_Hugo" } ]
PropertyValue (المعرّف)
تستخدم السمة identifier
لـ Edition
الوحدة PropertyValue
.
السمات المطلوبة | |
---|---|
@type |
اضبط النوع على |
propertyID |
تمثّل هذه السمة نوع المعرّف. وكما هو موضّح في رقم ISBN والمعرّفات الأخرى المتوافقة، يجب أن يكون النوع واحدًا مما يلي:
|
value |
تمثّل هذه السمة قيمة المعرّف. وهي المعرّف الخارجي الذي يعرّف هذا الإصدار بوضوح. يجب إزالة جميع البادئات غير الرقمية من المعرّف الخارجي. |
مثال على identifier
:
"identifier": { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "110123456" }
مثال مع عدة خصائص identifier
:
"identifier": [ { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "110123456" }, { "@type": "PropertyValue", "propertyID": "LCCN", "value": "220123456" },{ "@type": "PropertyValue", "propertyID": "JP_E-CODE", "value": "12345678901234567890" }]
مثال على ملف بتنسيق JSON لخلاصة ReadAction
Book
{ "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "Book", "@id": "https://example.com/work/the_catcher_in_the_rye", "url": "https://example.com/work/the_catcher_in_the_rye", "name": "The Catcher in the Rye", "author": { "@type": "Person", "name": "J.D. Salinger" }, "sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye", "workExample": [ { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_paperback", "isbn": "9787543321724", "bookEdition": "Mass Market Paperback", "bookFormat": "https://schema.org/Paperback", "inLanguage": "en", "url": "https://example.com/edition/the_catcher_in_the_rye_paperback", "datePublished": "1991-05-01", "identifier": { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "1057320822" }, "potentialAction": { "@type": "ReadAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/store/9787543321724", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] }, "expectsAcceptanceOf": { "@type": "Offer", "category": "purchase", "price": 6.99, "priceCurrency": "USD", "availabilityStarts": "2020-01-01T11:0:00-04:00", "availabilityEnds": "2050-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "US" } } } }, { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_hardcover", "isbn": "9780316769532", "bookEdition": "Hardcover", "bookFormat": "https://schema.org/Hardcover", "inLanguage": "en", "url": "https://example.com/edition/the_catcher_in_the_rye_hardcover", "datePublished": "1951-07-16", "potentialAction": { "@type": "ReadAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/store/9780316769532", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] }, "expectsAcceptanceOf": [ { "@type": "Offer", "category": "nologinrequired", "availabilityStarts": "2020-01-01T11:0:00-04:00", "availabilityEnds": "2050-06-30T23:59:00-04:00", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "GB" } ] }, { "@type": "Offer", "category": "Subscription", "availabilityStarts": "2020-01-01T11:0:00-04:00", "availabilityEnds": "2050-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "IN" } } ] } } ] } ], "dateModified": "2018-09-10T13:58:26.892Z" }
مثال على ملف بتنسيق JSON لخلاصة BorrowAction
Book
{ "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "Book", "@id": "https://example.com/work/the_catcher_in_the_rye", "url": "https://example.com/work/the_catcher_in_the_rye", "name": "The Catcher in the Rye", "author": { "@type": "Person", "name": "J.D. Salinger" }, "sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye", "workExample": [ { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_paperback", "isbn": "9787543321724", "bookEdition": "Mass Market Paperback", "bookFormat": "https://schema.org/Paperback", "inLanguage": "en", "url": "https://example.com/edition/the_catcher_in_the_rye_paperback", "datePublished": "1991-05-01", "identifier": { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "1057320822" }, "potentialAction": { "@type": "BorrowAction", "lender": { "@type": "LibrarySystem", "@id": "https://example.com/librarySystem/100" }, "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/borrowpurchase?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } } }, { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_hardcover", "isbn": "9780316769532", "bookEdition": "Hardcover", "bookFormat": "https://schema.org/Hardcover", "inLanguage": "en", "url": "https://example.com/edition/the_catcher_in_the_rye_hardcover", "datePublished": "1951-07-16", "potentialAction": { "@type": "BorrowAction", "lender": { "@type": "LibrarySystem", "@id": "https://example.com/librarySystem/100" }, "target": [ { "@type": "EntryPoint", "urlTemplate": "https://example.com/borrowpurchase?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform" ] }, { "@type": "EntryPoint", "urlTemplate": "https://example.com/mobile/borrowpurchase?bookId=170", "actionPlatform": [ "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } ] } } ] } ], "dateModified": "2018-09-10T13:58:26.892Z" }
ReadAction
(potentialAction
)
تستخدم السمة potentialAction
الكيان ReadAction
.
وتحدّد السمة ReadAction
روابط لمواضع معيّنة للوصول إلى الكتاب وبائع التجزئة الذي يخزّن نسخ عن الكتاب
والمعايير التي يجب أن يستوفيها المستخدمون. وقد تتضمن المعايير حالة الاشتراك أو حالة تسجيل الدخول أو الموقع الجغرافي أو غيرها من الشروط المطلوبة للوصول إلى الكتاب.
السمات المطلوبة | |
---|---|
@type |
اضبط النوع على |
expectsAcceptanceOf |
تمثّل هذه السمة تعريف المتطلبات المفروضة على المستخدم للوصول إلى هذا الكيان. في حال توفّر عدّة سمات يمكن تكرار هذه السمة. |
expectsAcceptanceOf.@type |
اضبط النوع على |
expectsAcceptanceOf.category |
تمثّل هذه السمة نوع
|
expectsAcceptanceOf.eligibleRegion |
البلد الذي يسري فيه هذا يمكن تكرار هذه السمة. |
expectsAcceptanceOf.eligibleRegion.@type |
اضبط النوع على |
expectsAcceptanceOf.eligibleRegion.name |
تمثّل هذه السمة رمز البلد وفقًا لمعيار ISO 3166-1 alpha-2. |
target |
تمثّل هذه السمة مواصفات الرابط الخاص بصفحة معيّنة والتي تشمل معلومات المنصات المتوافقة. يمكن استخدام خصائص يمكن تكرار هذه السمة. |
target.@type |
اضبط النوع على |
target.actionPlatform |
تمثّل هذه السمة الأنظمة الأساسية التي يعمل عليها الرابط الخاص بموضع معيّن. استخدِم إحدى القيم التالية:
يمكن تكرار هذه السمة. |
target.urlTemplate |
تمثّل هذه السمة الرابط الذي ينقل المستخدمين مباشرةً إلى محتوى الصفحة المقصودة في كتابك. |
السمات المقترَحة | |
---|---|
expectsAcceptanceOf.availabilityEnds |
تمثّل هذه السمة وقت انتهاء نافذة مدى التوفّر. ويمكن استخدامها لتحديد الوقت الدقيق الذي يجب فيه إيقاف عرض هذا الكتاب للمستخدمين. |
expectsAcceptanceOf.availabilityStarts |
تمثّل هذه السمة وقت بدء نافذة مدى التوفّر. ويمكن استخدامها لتحديد الوقت الدقيق الذي يمكن فيه عرض هذا الكتاب للمستخدمين. |
expectsAcceptanceOf.price |
تمثّل هذه الخاصية سعر شراء الكتاب. ويجب استخدامها عند ضبط الخاصية |
expectsAcceptanceOf.priceCurrency |
تمثّل هذه السمة العملة المستخدمة للسعر بتنسيق ISO 4217 المكوّن من ثلاثة أحرف. |
مثال على ReadAction
:
"potentialAction": { "@type": "ReadAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/purchase?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] }, "expectsAcceptanceOf": { "@type": "Offer", "category": "purchase", "price": "9.99", "priceCurrency": "USD", "availabilityStarts": "2018-04-01T11:01:00-04:00", "availabilityEnds": "2018-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "US" } } }
مثال على ReadAction
مع عدة خصائص EntryPoint
:
"potentialAction": { "@type": "ReadAction", "target": [ { "@type": "EntryPoint", "urlTemplate": "https://example.com/purchase?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform" ] }, { "@type": "EntryPoint", "urlTemplate": "https://example.com/mobile/purchase?bookId=170", "actionPlatform": [ "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } ], "expectsAcceptanceOf": [ { "@type": "Offer", "category": "noLoginRequired", "availabilityStarts": "2018-04-01T11:01:00-04:00", "availabilityEnds": "2018-06-30T23:59:00-04:00", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "GB" } ] }, { "@type": "Offer", "category": "Subscription", "availabilityStarts": "2018-04-01T11:01:00-04:00", "availabilityEnds": "2018-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "IN" } } ] }
BorrowAction
(potentialAction
)
تستخدم السمة potentialAction
الكيان BorrowAction
.
وتحدّد الخاصية BorrowAction
روابط لمواضع معيّنة للوصول إلى الكتاب والمكتبة التي توفّر الكتب والمعايير التي يجب أن يستوفيها المستخدمون. وقد تتضمن المعايير حالة الاشتراك أو حالة تسجيل الدخول أو الموقع الجغرافي أو غيرها من الشروط المطلوبة للوصول إلى الكتاب.
السمات المطلوبة | |
---|---|
@type |
اضبط النوع على |
lender |
تمثّل هذه السمة نظام المكتبة الذي يوفّر إمكانية الوصول إلى هذا الإصدار. |
lender.@id |
تمثّل هذه السمة مَراجع المعرّف للسمة |
lender.@type |
اضبط النوع على |
target |
تمثّل هذه السمة مواصفات الرابط الخاص بصفحة معيّنة والتي تشمل معلومات المنصات المتوافقة. لتحديد روابط لمواضع معيّنة لمجموعات مختلفة من الأنظمة الأساسية، يمكنك تحديد مصفوفة يمكن تكرار هذه السمة. |
target.@type |
اضبط النوع على |
target.actionPlatform |
تمثّل هذه السمة الأنظمة الأساسية التي يعمل عليها الرابط الخاص بموضع معيّن. استخدِم إحدى القيم التالية:
يمكن تكرار هذه السمة. |
target.urlTemplate |
تمثّل هذه السمة الرابط الذي ينقل المستخدمين مباشرةً إلى محتوى الصفحة المقصودة في كتابك. |
مثال على BorrowAction
:
"potentialAction": { "@type": "BorrowAction", "lender": { "@type": "LibrarySystem", "@id": "https://example.com/librarySystem/100" }, "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/borrow?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } }
مثال على BorrowAction
مع عدة خصائص EntryPoint
:
"potentialAction": { "@type": "BorrowAction", "lender": { "@type": "LibrarySystem", "@id": "https://example.com/librarySystem/100" }, "target": [ { "@type": "EntryPoint", "urlTemplate": "https://example.com/borrow?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform" ] }, { "@type": "EntryPoint", ` "urlTemplate": "https://example.com/mobile/borrow?bookId=170", "actionPlatform": [ "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } ] }
كيان Library
يتوفّر تعريف Library
الكامل على schema.org/Library،
ولكن يجب مراعاة الخصائص التالية فقط. عليك تحديد السمات المطلوبة لكل مكتبة تختار تضمينها في خلاصتك.
ويمكنك أيضًا تحديد السمات المقترَحة لإضافة المزيد من المعلومات المتعلقة بالمحتوى، ما يؤدي إلى تحسين تجربة المستخدم.
يمثّل كيان Library
المستوى الأعلى من نوع الكيان في Library
. وهذا الكيان هو عبارة عن بنية مجرّدة تتكوّن من كيان LibrarySystem
وكل كيان في Library (member)
بمستوى أقل من LibrarySystem
.
تختلف خلاصة Library
عن خلاصة Book
. بالتالي، يجب أن تكون أي خلاصة Library
قد تطبّقها منفصلة تمامًا عن خلاصة Book
.
للحصول على المزيد من المعلومات، راجِع القسم إنشاء خلاصتك.
LibrarySystem
يمثل الكيان LibrarySystem
شبكة تعاونية مؤلّفة من أعضاء المكتبة.
السمات المطلوبة | |
---|---|
@context
|
Text
اضبط النوع على |
@id
|
URL
تمثّل هذه السمة معرّفًا فريدًا عالميًا لنظام المكتبة بتنسيق URL. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. ويتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا. يجب أن يكون النطاق
الذي يتم استخدامه في القيمة |
@type
|
Text
اضبط النوع على |
additionalProperty
|
PropertyValue
هذه هي السمة الإضافية المستخدمة لتحديد نوع المكتبة. |
additionalProperty.@type
|
Text
اضبط النوع على |
additionalProperty.name
|
Text
اضبِط النوع على |
additionalProperty.value
|
Text
تمثّل هذه السمة نوع المكتبة. استخدِم إحدى القيم التالية:
|
member
|
Library
تمثّل هذه السمة المشتركين في نظام المكتبة. |
name
|
Text
تمثّل هذه السمة اسم نظام المكتبة. مثلاً،
|
url
|
URL
تمثّل هذه السمة عنوان URL الذي يقدّم وصفًا أو معلومات عن نظام المكتبة. ويستخدم "بحث Google" هذا الرابط للتوفيق بين محتوى خلاصتك والمحتوى المدرَج في قواعد بيانات Google. بالنسبة إلى الصفحة المقصودة، يستخدم "بحث Google" عنوان URL المقدّم في |
Library
(member
)
تستخدم السمة member
للكيان LibrarySystem
الكيان Library (member)
.
وتمثّل السمة Library (member)
عضو مكتبة واحدًا في نظام مكتبة معيّن.
السمات المطلوبة | |
---|---|
@id
|
URL
تمثّل هذه الخاصية معرّفًا فريدًا عالميًا لفرع المكتبة بتنسيق عنوان URL. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. ويتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا. يجب أن يكون النطاق
الذي يتم استخدامه في القيمة |
@type
|
Text
اضبط النوع على |
location
|
PostalAddress
تمثّل هذه السمة عنوان الشارع لفرع المكتبة. وتنطبق بعض السمات في بعض البلدان فقط. ويجب أن تضمِّن أكبر عدد ممكن من العناوين التي تنطبق على عناوين مكتباتك. مثال { "@type": "Library", "@id": "https://example.com/library-branches/1001", "name": "Campbell Library", "location": { "@type": "PostalAddress", "streetAddress": "77 Harrison Ave", "addressLocality": "Campbell", "addressRegion": "CA", "postalCode": "95008", "addressCountry": "US" } } مثال { "@type": "Library", "@id": "https://example.com/library-branches/1003", "name": "Tokyo Metropolitan Central Library", "location": { "@type": "PostalAddress", "streetAddress": "7-13-5 Minamiazabu, Minato City", "addressLocality": "Tokyo", "postalCode": "106-0047", "addressCountry": "JP" } } |
location.@type
|
Text
اضبط النوع على |
location.addressCountry
|
Text
تمثّل هذه السمة رمز البلد بتنسيق ISO 3166-1. مثلاً: |
location.addressLocality
|
Text
تمثّل هذه السمة المنطقة المحلية. مثلاً: |
location.addressRegion
|
Text
تمثّل هذه السمة المنطقة. مثلاً: |
location.postalCode
|
Text
تمثّل هذه السمة الرمز البريدي. مثلاً: |
location.streetAddress
|
Text
تمثّل هذه السمة عنوان الشارع. مثلاً: |
name
|
Text
تمثّل هذه السمة اسم فرع المكتبة. |
مثال على ملف بتنسيق JSON لخلاصة LibrarySystem
{ "@context": "https://schema.org", "@type":"LibrarySystem", "@id":"https://example.com/library-systems/100", "name":"Santa Clara County Library District", "additionalProperty":[ { "@type":"PropertyValue", "name":"librarytype", "value":"public" } ], "member":[ { "@type":"Library", "@id":"https://example.com/library-branches/1001", "name":"Campbell Library", "location":{ "@type":"PostalAddress", "streetAddress":"77 Harrison Ave", "addressLocality":"Campbell", "addressRegion":"CA", "postalCode":"95008", "addressCountry":"US" } }, { "@type":"Library", "@id":"https://example.com/library-branches/1002", "name":"Gilroy Library", "location":{ "@type":"PostalAddress", "streetAddress":"350 W 6th St", "addressLocality":"Gilroy", "addressRegion":"CA", "postalCode":"95020", "addressCountry":"US" } } ] }