البيانات المنظَّمة للإجراءات المتعلقة بالكتب (Book)

من خلال الإجراءات المتعلقة بالكتب، يصبح "بحث Google" مساحة لاكتشاف الكتب والمؤلفين. ويتيح ذلك لمستخدمي "بحث Google‏" شراء أو استعارة الكتب التي يعثرون عليها مباشرةً وبسرعة من نتائج البحث. على سبيل المثال، يمكن للمستخدم البحث عن كتاب Charlotte's Web، وسيتم عرض النتائج التي تسمح له بشراء الكتاب أو استعارته. بصفتك موفّرًا للكتب، يمكنك تقديم خلاصة بيانات إلى Google باستخدام مخطط البيانات المنظَّمة المقدَّم هنا. وتوفّر مواصفاتنا السمة ReadAction للسماح للمستخدمين بشراء كتاب والسمة BorrowAction للسماح لهم باستعارة كتاب.

إجراء متعلّق بالكتب في نتائج "بحث Google"

تعرض إجراءات القراءة وإجراءات الاستعارة خيارات لشراء الكتاب أو استعارته، وهي مدمَجة في اللوحات. ومن خلال الروابط التي توفّرها، تنقل إجراءات القراءة وإجراءات الاستعارة المستخدمين مباشرةً من بطاقة المعلومات وغيرها من مساحات عرض 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

Text

اضبط النوع على https://schema.org.

@type

Text

اضبط النوع على DataFeed.

dataFeedElement

Book أو LibrarySystem

اضبط السمة إما على الكيان Book واحد أو على الكيان LibrarySystem. ويمكنك أيضًا ضبطها على مصفوفة من كيانات Book فقط أو من كيانات LibrarySystem. ولا تضبط الخاصية على مصفوفة تتضمّن كلاً من كيانات Book وكيانات LibrarySystem.

مثال على الاستخدام في خلاصة 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",
          ...
        },
        ...
      ]
   }
  ],
  "dateModified": "2018-09-10T13:58:26.892Z"
}

مثال على الاستخدام في خلاصة LibrarySystem:

{
  "@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

DateTime

تمثّل هذه الخاصية تاريخ ووقت آخر تعديل أُجري على الخلاصة بتنسيق ISO 8601.

كيان Book

يتوفّر تعريف Book الكامل على schema.org/Book، ولكن يجب مراعاة الخصائص التالية فقط. يجب تحديد السمات المطلوبة لكل كتاب تختار تضمينه في خلاصتك. ويمكنك تحديد السمات المقترَحة لإضافة المزيد من المعلومات المتعلقة بالمحتوى، ما يؤدي إلى تحسين تجربة المستخدم.

Book (Work)

كيان Book هذا هو نوع الكيان ذو المستوى الأعلى. وهو يمثّل العمل.

في ما يلي السمات المتوافقة مع Google:

السمات المطلوبة
@context

Text

اضبط النوع على https://schema.org.

@id

Text

تمثّل هذه السمة معرّفًا فريدًا عالميًا للكتاب بتنسيق عنوان URL. ويجب أن يكون فريدًا لمؤسستك. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. وننصحك باستخدام تنسيق عنوان URL ولكن ذلك ليس إلزاميًا. ولا يُشترط أن يكون رابطًا منشورًا. ويجب أن يكون النطاق المستخدَم للقيمة @id مملوكًا من مؤسستك.

@type

Text

اضبط النوع على Book.

author

Person أو Organization

تمثّل هذه السمة مؤلّفي الكتاب.

name

Text

تمثّل هذه السمة عنوان الكتاب.

url

URL

تمثّل هذه السمة عنوان URL على الموقع الإلكتروني الذي يتضمن وصفًا أو معلومات عن الكتاب. ويساعد هذا الرابط في التوفيق بدقة بين المحتوى في خلاصتك والمحتوى في قواعد بيانات Google. ويمكن أن يتطابق الرابط مع workExample.target.urlTemplate.

بالنسبة إلى الصفحة المقصودة، تستخدم خدمة "بحث Google‏" عنوان URL المقدَّم في workExample.target.urlTemplate.

workExample

Book (Edition)

تمثّل هذه السمة إصدارات العمل.

السمات المقترَحة
sameAs

URL

تمثّل هذه السمة عنوان URL لصفحة مرجعية تشير إلى نوع العمل. على سبيل المثال، الصفحة الخاصة بالكتاب في ويكيبيديا أو Wikidata أو VIAF أو مكتبة الكونغرس.

Book (Edition)

تستخدم السمة workExample الوحدة Book هذه. وتمثّل إصدارًا من العمل.

في ما يلي السمات المتوافقة مع Google:

السمات المطلوبة
@id

Text

تمثّل هذه السمة معرّفًا فريدًا عالميًا للكتاب بتنسيق عنوان URL. ويجب أن يكون فريدًا لمؤسستك. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. وننصحك باستخدام تنسيق عنوان URL ولكن ذلك ليس إلزاميًا. ولا يُشترط أن يكون رابطًا منشورًا. ويجب أن يكون النطاق المستخدَم للقيمة @id مملوكًا من مؤسستك.

@type

Text

اضبط النوع على Book.

bookFormat

Enum

تمثّل هذه السمة تنسيق الإصدار. ويجب أن تكون قيمة من إحدى القيم التالية:

  • https://schema.org/AudiobookFormat
  • https://schema.org/EBook
  • https://schema.org/Hardcover
  • https://schema.org/Paperback
inLanguage

Text

تمثّل هذه السمة اللغة الرئيسية للمحتوى في الإصدار. استخدِم أحد الرموز المكوَّنة من حرفَين من قائمة رموز ISO 639-1 alpha-2.

isbn

Text

تمثّل هذه السمة رقم ISBN المكوّن من 13 رقمًا للإصدار. إذا كان لديك رقم ISBN مكوّن من 10 أرقام، عليك تحويله إلى رقم ISBN مكوّن من 13 رقمًا.

potentialAction

ReadAction أو BorrowAction

تمثّل هذه الخاصية الإجراء الذي سيتم تشغيله للمستخدمين عند شراء الكتاب أو تنزيله. لمزيد من التفاصيل، راجِع ReadAction أو BorrowAction.

السمات المقترَحة
author

Person أو Organization

تمثّل هذه السمة مؤلّفي الإصدار.

bookEdition

Text

تمثّل هذه السمة معلومات عن إصدار الكتاب. مثلاً: 2nd Edition

datePublished

Date

تاريخ نشر الإصدار بتنسيق YYYY-MM-DD أو YYYY: وقد يكون إما تاريخًا محددًا أو سنة معيّنة.

identifier

PropertyValue

تمثّل هذه الخاصية المعرّف الخارجي أو المعرّف الآخر الذي يعرّف هذا الإصدار بوضوح. ويُسمح باستخدام عدّة معرّفات. لمزيد من التفاصيل، راجِع PropertyValue (identifier).

يمكن تكرار هذه السمة.

name

Text

تمثّل هذه السمة عنوان الإصدار. وتُستخدم هذه السمة فقط إذا كان عنوان الإصدار مختلفًا عن عنوان العمل.

sameAs

URL

تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية تشير بوضوح إلى الإصدار. على سبيل المثال، صفحة ويكيبيديا لهذا الإصدار تحديدًا. ويجب عدم إعادة استخدام sameAs من Work.

url

URL

تمثّل هذه السمة عنوان URL لموقعك الإلكتروني الذي يتضمن وصفًا أو معلومات عن الإصدار. ويمكن أن يتطابق العنوان مع workExample.target.urlTemplate.

مثال على 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

Text

اضبط النوع على Person أو Organization.

name

Text

تمثّل هذه السمة اسم الشخص أو المؤسسة.

السمات المقترَحة
sameAs

URL

تمثّل هذه السمة عنوان 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

Text

اضبط النوع على PropertyValue.

propertyID

Text

تمثّل هذه السمة نوع المعرّف. وكما هو موضّح في رقم ISBN والمعرّفات الأخرى المتوافقة، يجب أن يكون النوع واحدًا مما يلي:

  • OCLC_NUMBER
  • LCCN
  • JP_E-CODE
value

Text

تمثّل هذه السمة قيمة المعرّف. وهي المعرّف الخارجي الذي يعرّف هذا الإصدار بوضوح. يجب إزالة جميع البادئات غير الرقمية من المعرّف الخارجي.

مثال على 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

Text

اضبط النوع على ReadAction.

expectsAcceptanceOf

Offer

تمثّل هذه السمة تعريف المتطلبات المفروضة على المستخدم للوصول إلى هذا الكيان. في حال توفّر عدّة سمات Offer، قد يتمكّن مستخدم يطابق أيًا من معايير Offer من الوصول إلى المحتوى.

يمكن تكرار هذه السمة.

expectsAcceptanceOf.@type

Text

اضبط النوع على Offer.

expectsAcceptanceOf.category

Text

تمثّل هذه السمة نوع Offer. ويجب أن يكون قيمة من القيم التالية:

  • nologinrequired: الإجراء متاح للمستخدم ولا يتطلب الشراء أو تسجيل الدخول للوصول إلى المحتوى.
  • free: الإجراء متاح بدون الشراء أو الحصول على اشتراك مدفوع، ولكنه يتطلب تسجيل دخول المستخدم.
  • subscription: الكتاب مضمّن في خدمتك عن طريق اشتراك مدفوع.
  • purchase: يمكن الوصول إلى الكتاب عن طريق عملية شراء.
  • rental: يمكن الوصول إلى الكتاب لمدة زمنية محدودة بعد الشراء.
expectsAcceptanceOf.eligibleRegion

Country

البلد الذي يسري فيه هذا Offer: يمكن استخدام هذه السمة لتحديد البلد والمنطقة التي يتوفّر أو لا يتوفّر فيها هذا المحتوى.

يمكن تكرار هذه السمة.

expectsAcceptanceOf.eligibleRegion.@type

Text

اضبط النوع على Country.

expectsAcceptanceOf.eligibleRegion.name

Text

تمثّل هذه السمة رمز البلد وفقًا لمعيار ISO 3166-1 alpha-2.

target

EntryPoint

تمثّل هذه السمة مواصفات الرابط الخاص بصفحة معيّنة والتي تشمل معلومات المنصات المتوافقة. يمكن استخدام خصائص EntryPoint متعدّدة لتحديد روابط مختلفة خاصّة بمواضع معيّنة على مجموعات مختلفة من الأنظمة الأساسية.

يمكن تكرار هذه السمة.

target.@type

Text

اضبط النوع على EntryPoint.

target.actionPlatform

Text

تمثّل هذه السمة الأنظمة الأساسية التي يعمل عليها الرابط الخاص بموضع معيّن. استخدِم إحدى القيم التالية:

  • https://schema.org/DesktopWebPlatform
  • https://schema.org/AndroidPlatform
  • https://schema.org/IOSPlatform

يمكن تكرار هذه السمة.

target.urlTemplate

URL

تمثّل هذه السمة الرابط الذي ينقل المستخدمين مباشرةً إلى محتوى الصفحة المقصودة في كتابك.

السمات المقترَحة
expectsAcceptanceOf.availabilityEnds

DateTime

تمثّل هذه السمة وقت انتهاء نافذة مدى التوفّر. ويمكن استخدامها لتحديد الوقت الدقيق الذي يجب فيه إيقاف عرض هذا الكتاب للمستخدمين.

expectsAcceptanceOf.availabilityStarts

DateTime

تمثّل هذه السمة وقت بدء نافذة مدى التوفّر. ويمكن استخدامها لتحديد الوقت الدقيق الذي يمكن فيه عرض هذا الكتاب للمستخدمين.

expectsAcceptanceOf.price

Number

تمثّل هذه الخاصية سعر شراء الكتاب. ويجب استخدامها عند ضبط الخاصية category في Offer على purchase أو rental.

expectsAcceptanceOf.priceCurrency

Text

تمثّل هذه السمة العملة المستخدمة للسعر بتنسيق 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

Text

اضبط النوع على BorrowAction.

lender

LibrarySystem

تمثّل هذه السمة نظام المكتبة الذي يوفّر إمكانية الوصول إلى هذا الإصدار.

lender.@id

URL

تمثّل هذه السمة مَراجع المعرّف للسمة LibrarySystem، والتي يجب وصفها بالكامل بشكل منفصل في خلاصة المكتبة.

lender.@type

Text

اضبط النوع على LibrarySystem.

target

EntryPoint

تمثّل هذه السمة مواصفات الرابط الخاص بصفحة معيّنة والتي تشمل معلومات المنصات المتوافقة. لتحديد روابط لمواضع معيّنة لمجموعات مختلفة من الأنظمة الأساسية، يمكنك تحديد مصفوفة EntryPoint.

يمكن تكرار هذه السمة.

target.@type

Text

اضبط النوع على EntryPoint.

target.actionPlatform

Text

تمثّل هذه السمة الأنظمة الأساسية التي يعمل عليها الرابط الخاص بموضع معيّن. استخدِم إحدى القيم التالية:

  • https://schema.org/DesktopWebPlatform
  • https://schema.org/AndroidPlatform
  • https://schema.org/IOSPlatform

يمكن تكرار هذه السمة.

target.urlTemplate

URL

تمثّل هذه السمة الرابط الذي ينقل المستخدمين مباشرةً إلى محتوى الصفحة المقصودة في كتابك.

مثال على 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

اضبط النوع على https://schema.org.

@id URL

تمثّل هذه السمة معرّفًا فريدًا عالميًا لنظام المكتبة بتنسيق URL. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. ويتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا. يجب أن يكون النطاق الذي يتم استخدامه في القيمة @id ملكًا لمؤسستك.

@type Text

اضبط النوع على LibrarySystem.

additionalProperty PropertyValue

هذه هي السمة الإضافية المستخدمة لتحديد نوع المكتبة.

additionalProperty.@type Text

اضبط النوع على PropertyValue.

additionalProperty.name Text

اضبِط النوع على librarytype.

additionalProperty.value Text

تمثّل هذه السمة نوع المكتبة. استخدِم إحدى القيم التالية:

  • public
  • academic
  • corporate
  • government
  • school
  • special
member Library

تمثّل هذه السمة المشتركين في نظام المكتبة.

name Text

تمثّل هذه السمة اسم نظام المكتبة. مثلاً، The Southwestern League of Libraries.

url URL

تمثّل هذه السمة عنوان URL الذي يقدّم وصفًا أو معلومات عن نظام المكتبة. ويستخدم "بحث Google‏" هذا الرابط للتوفيق بين محتوى خلاصتك والمحتوى المدرَج في قواعد بيانات Google. بالنسبة إلى الصفحة المقصودة، يستخدم "بحث Google‏" عنوان URL المقدّم في workExample.target.urlTemplate.

Library (member)

تستخدم السمة member للكيان LibrarySystem الكيان Library (member). وتمثّل السمة Library (member) عضو مكتبة واحدًا في نظام مكتبة معيّن.

السمات المطلوبة
@id URL

تمثّل هذه الخاصية معرّفًا فريدًا عالميًا لفرع المكتبة بتنسيق عنوان URL. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. ويتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا. يجب أن يكون النطاق الذي يتم استخدامه في القيمة @id ملكًا لمؤسستك.

@type Text

اضبط النوع على Library.

location PostalAddress

تمثّل هذه السمة عنوان الشارع لفرع المكتبة. وتنطبق بعض السمات في بعض البلدان فقط. ويجب أن تضمِّن أكبر عدد ممكن من العناوين التي تنطبق على عناوين مكتباتك.

مثال location في الولايات المتحدة:

{
  "@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"
  }
}

مثال location في اليابان:

{
  "@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

اضبط النوع على PostalAddress.

location.addressCountry Text

تمثّل هذه السمة رمز البلد بتنسيق ISO 3166-1. مثلاً: US

location.addressLocality Text

تمثّل هذه السمة المنطقة المحلية. مثلاً: Mountain View

location.addressRegion Text

تمثّل هذه السمة المنطقة. مثلاً: CA

location.postalCode Text

تمثّل هذه السمة الرمز البريدي. مثلاً: 94043

location.streetAddress Text

تمثّل هذه السمة عنوان الشارع. مثلاً: 1600 Amphitheatre Pkwy

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"
         }
      }
   ]
}