كتاب

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

إجراء متعلّق بالكتب في نتائج "بحث 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": "http://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.

الخصائص المطلوبة
@context

Text

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

@type

Text

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

dataFeedElement

Book أو LibrarySystem

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

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


{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dataFeedElement": [
    {
      "@context": "http://schema.org",
      "@type": "Book",
      "@id": "http://example.com/work/the_catcher_in_the_rye",
      "url": "http://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": "http://example.com/edition/the_catcher_in_the_rye_paperback",
          "isbn": "9787543321724",
          "bookEdition": "Mass Market Paperback",
          "bookFormat": "http://schema.org/Paperback",
          "inLanguage": "en",
          ...
        },
        ...
      ]
   }
  ],
  "dateModified": "2018-09-10T13:58:26.892Z"
}

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


{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dataFeedElement": [
    {
      "@context": "http://schema.org",
      "@type": "LibrarySystem",
      "@id": "http://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 هذا هو نوع الكيان ذو المستوى الأعلى. وهو يمثّل العمل.

الخصائص المطلوبة
@context

Text

اضبط النوع على http://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 هذا. وتمثّل إصدارًا من العمل.

الخصائص المطلوبة
@id

Text

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

@type

Text

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

bookFormat

Enum

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

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

Text

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

isbn

Text

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

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": "http://example.com/book/100",
          "inLanguage": "en",
          "isbn": "8920000030001",
          "bookEdition": "20 Anniversary Edition",
          "datePublished": "2000-02-26",
          "bookFormat": "http://schema.org/Hardcover",
          "potentialAction": {...}
        }

مثال على Book (Edition) مع عدة خصائص workExample:

"workExample": [
        {
          "@type": "Book",
          "@id": "http://example.com/book/200",
          "inLanguage": "zh",
          "isbn": "9000031676948",
          "bookEdition": "2nd Edition",
          "bookFormat": "http://schema.org/Hardcover",
          "potentialAction": {...}
        },
        {
          "@type": "Book",
          "@id": "http://example.com/book/300",
          "inLanguage": "zh",
          "isbn": "90000031676947",
          "bookEdition": "1st Edition",
          "bookFormat": "http://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": "http://schema.org",
  "@type": "DataFeed",
  "dataFeedElement": [
    {
      "@context": "http://schema.org",
      "@type": "Book",
      "@id": "http://example.com/work/the_catcher_in_the_rye",
      "url": "http://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": "http://example.com/edition/the_catcher_in_the_rye_paperback",
          "isbn": "9787543321724",
          "bookEdition": "Mass Market Paperback",
          "bookFormat": "http://schema.org/Paperback",
          "inLanguage": "en",
          "url": "http://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": "http://example.com/store/9787543321724",
              "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://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": "http://example.com/edition/the_catcher_in_the_rye_hardcover",
          "isbn": "9780316769532",
          "bookEdition": "Hardcover",
          "bookFormat": "http://schema.org/Hardcover",
          "inLanguage": "en",
          "url": "http://example.com/edition/the_catcher_in_the_rye_hardcover",
          "datePublished": "1951-07-16",
          "potentialAction": {
            "@type": "ReadAction",
            "target": {
              "@type": "EntryPoint",
              "urlTemplate": "http://example.com/store/9780316769532",
              "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://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": "http://schema.org",
  "@type": "DataFeed",
  "dataFeedElement": [
    {
      "@context": "http://schema.org",
      "@type": "Book",
      "@id": "http://example.com/work/the_catcher_in_the_rye",
      "url": "http://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": "http://example.com/edition/the_catcher_in_the_rye_paperback",
          "isbn": "9787543321724",
          "bookEdition": "Mass Market Paperback",
          "bookFormat": "http://schema.org/Paperback",
          "inLanguage": "en",
          "url": "http://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": "http://example.com/librarySystem/100"
            },
            "target": {
              "@type": "EntryPoint",
              "urlTemplate": "http://example.com/borrowpurchase?bookId=170",
              "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://schema.org/IOSPlatform"
              ]
            }
          }
        },
        {
          "@type": "Book",
          "@id": "http://example.com/edition/the_catcher_in_the_rye_hardcover",
          "isbn": "9780316769532",
          "bookEdition": "Hardcover",
          "bookFormat": "http://schema.org/Hardcover",
          "inLanguage": "en",
          "url": "http://example.com/edition/the_catcher_in_the_rye_hardcover",
          "datePublished": "1951-07-16",
          "potentialAction": {
            "@type": "BorrowAction",
            "lender": {
              "@type": "LibrarySystem",
              "@id": "http://example.com/librarySystem/100"
            },
            "target": [
              {
                "@type": "EntryPoint",
                "urlTemplate": "http://example.com/borrowpurchase?bookId=170",
                "actionPlatform": [
                  "http://schema.org/DesktopWebPlatform"
                ]
              },
              {
                "@type": "EntryPoint",
                "urlTemplate": "http://example.com/mobile/borrowpurchase?bookId=170",
                "actionPlatform": [
                  "http://schema.org/AndroidPlatform",
                  "http://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

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

  • http://schema.org/DesktopWebPlatform
  • http://schema.org/AndroidPlatform
  • http://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": "http://example.com/purchase?bookId=170",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://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": "http://example.com/purchase?bookId=170",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform"
      ]
    },
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/mobile/purchase?bookId=170",
      "actionPlatform": [
        "http://schema.org/AndroidPlatform",
        "http://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

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

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

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

target.urlTemplate

URL

تمثّل هذه الخاصية الرابط الذي يؤدي إلى تشغيل المحتوى.

مثال على BorrowAction:

"potentialAction": {
  "@type": "BorrowAction",
  "lender": {
    "@type": "LibrarySystem",
    "@id": "http://example.com/librarySystem/100"
  },
  "target": {
    "@type": "EntryPoint",
    "urlTemplate": "http://example.com/borrow?bookId=170",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/IOSPlatform"
    ]
  }
}

مثال على BorrowAction مع عدة خصائص EntryPoint:

"potentialAction": {
  "@type": "BorrowAction",
  "lender": {
    "@type": "LibrarySystem",
    "@id": "http://example.com/librarySystem/100"
  },
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/borrow?bookId=170",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform"
      ]
    },
    {
      "@type": "EntryPoint",
`      "urlTemplate": "http://example.com/mobile/borrow?bookId=170",
      "actionPlatform": [
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform"
      ]
    }
  ]
}

كيان Library

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

يمثّل كيان Library المستوى الأعلى من نوع الكيان في Library. وهو عبارة عن بنية مجرّدة تتكوّن من كيان LibrarySystem وكل كيان في Library (member) بمستوى أقل من LibrarySystem.

تختلف خلاصة Library عن خلاصة Book. بالتالي، يجب أن تكون أي خلاصة Library قد تطبّقها منفصلة تمامًا عن خلاصة Book. للحصول على المزيد من المعلومات، راجِع القسم إنشاء خلاصتك.

LibrarySystem

يمثل الكيان LibrarySystem شبكة تعاونية مؤلّفة من أعضاء المكتبة.

الخصائص المطلوبة
@context Text

اضبط النوع على http://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": "http://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": "http://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": "http://schema.org",
   "@type":"LibrarySystem",
   "@id":"http://example.com/library-systems/100",
   "name":"Santa Clara County Library District",
   "additionalProperty":[
      {
         "@type":"PropertyValue",
         "name":"librarytype",
         "value":"public"
      }
   ],
   "member":[
      {
         "@type":"Library",
         "@id":"http://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":"http://example.com/library-branches/1002",
         "name":"Gilroy Library",
         "location":{
            "@type":"PostalAddress",
            "streetAddress":"350 W 6th St",
            "addressLocality":"Gilroy",
            "addressRegion":"CA",
            "postalCode":"95020",
            "addressCountry":"US"
         }
      }
   ]
}