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

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

تعرض إجراءات القراءة وإجراءات الاستعارة خيارات لشراء الكتاب أو استعارته، وهي مدمَجة في اللوحات. ومن خلال الروابط التي توفّرها، تنقل إجراءات القراءة وإجراءات الاستعارة المستخدمين مباشرةً من بطاقة المعلومات وغيرها من مساحات عرض Google إلى صفحة الكتاب على موقعك الإلكتروني أو في تطبيقك.

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

البدء

لتنفيذ الإجراءات المتعلقة بالكتب بنجاح، عليك إنشاء خلاصتك وفقًا لتعريفات أنواع البيانات المنظَّمة الخاصة بإجراءات الكتب، ولكن عليك أولاً مراجعة الأقسام التالية:

• الإرشادات
• إنشاء الخلاصة
• اختبار خلاصتك باستخدام أداة التحقق من خلاصة البيانات
• استضافة ملف الخلاصة
• إرسال ملف الخلاصة للمراجعة
• تعديل الخلاصة حسب الحاجة

الإرشادات

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

لمساعدتك في تنفيذ ذلك، اتّبِع الإرشادات الموضّحة هنا، بالإضافة إلى الإرشادات العامة للبيانات المنظَّمة وأساسيات "بحث Google". إليك الإرشادات:

• الأعمال والإصدارات
• أنظمة المكتبة وأعضاء المكتبة
• رقم ISBN والمعرّفات الأخرى المتوافقة
• الروابط

الأعمال والإصدارات

في هذه المستندات، نستخدم عبارتَين مختلفتَين عندما نتحدث عن كتاب:

• العمل: هو المفهوم المجرّد للكتاب. على وجه التحديد، تتكوّن سمات العمل من بيانات وصفية مثل العنوان والمؤلف واللغة الأصلية.
• الإصدار: هو نسخة مادية من الكتاب. على وجه التحديد، تتكوّن سمات الإصدار من بيانات وصفية مثل سنة النشر واسم الإصدار ورقم الكتاب المعياري الدولي (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.
• إذا كانت لديك عدّة ملفات للخلاصة، يمكنك تحميلها كما هي، أو يمكنك تضمينها كجزء من ملف فهرسة خرائط الموقع إذا كنت تفضّل ذلك.
• يجب أن تتضمّن ملفات الخلاصة الفردية الإضافة .json في اسم الملف.

الالتزام بمتطلبات محتوى الخلاصة

الالتزام بشكل خاص بمتطلبات محتوى الخلاصة التالية التي يجب التقيّد بها:

• يجب ألا تتضمّن الخلاصة كيانات قديمة. الكيانات القديمة هي كيانات تم ضبط السمة availabilityEnds فيها على تاريخ في الماضي أو كيانات لم تعُد متاحة على موقعك الإلكتروني.
• إنّ كل الروابط لصفحات معيّنة، مثل urlTemplate، وجميع عناوين URL، مثل url التي تُدرجها في خلاصتك يجب أن تكون عناوين URL إنتاجية. ولا تستخدم عناوين تأكيد الجودة أو التطوير أو أي نوع آخر من عناوين URL غير الإنتاجية.
• يجب أن تكون جميع عناوين URL، مثل url، عناوين أساسية.
• يجب أن يحدّد كل كيان في خلاصتك الخصائص التالية:
  • معرّف فريد: @id
  • عنوان URL فريد: url
  • رابط لصفحة معيّنة فريدة: urlTemplate

اختبار الخلاصة باستخدام أداة التحقق من خلاصة البيانات

ننصحك باتّباع الخطوات التالية لتحديد المشاكل وحلّها بهدف معالجة الأخطاء والتحذيرات الشائعة في أداة التحقق من خلاصة البيانات:

• تأكّد من تحديد الخيار الصحيح في الحقل التحقق من الصحة على. اختَر إجراءات الكتب للكيان Book.

• تأكّد من كتابة قيمة @type بشكل صحيح.
• تأكّد من ضبط قيمة @context بشكل صحيح. اضبط "@context": "https://schema.org" في كل من ReadAction وBorrowAction.

استضافة ملف الخلاصة

عندما يصبح ملف الخلاصة جاهزًا، يمكنك استضافته في موقع آمن. تجلب Google الخلاصة بشكل دوري للتأكّد من عرض أحدث محتوى خاص بك.

طرق الاستضافة

تتوفّر الطرق التالية لاستضافة الخلاصات:

إرسال ملف الخلاصة للمراجعة

لكي يكون المحتوى الخاص بك متاحًا في "بحث Google‏"، يراجع فريق دعم Google جودة الروابط الخاصة بمواضع معيّنة في خلاصتك. ونشدّد على أهمية اختبار بعض الروابط الخاصة بمواضع معيّنة في التطبيق للتأكّد من أنّها تفتح الصفحة حيث يمكن للمستخدمين شراء أو استعارة الكتب.

لطلب مراجعة خلاصتك، يُرجى تقديم ما يلي:

• موقع المضيف: عنوان URL لملف الخلاصة.
• مصادقة المضيف إذا توفّرت: بيانات اعتماد المصادقة للسماح لمحرّك البحث Google بالحصول على ملف الخلاصة من موقع المضيف.

تعديل الخلاصة حسب الحاجة

ننصحك بتعديل خلاصتك يوميًا، ولكن هذا يعتمد بشكل أساسي على عدد مرات تغيير الكتالوج. ويُرجى الانتباه إلى الشروط والملاحظات التالية:

• لا يتيح محرّك بحث Google إمكانية تعديل المحتوى في الوقت الفعلي.
• يجلب محرّك بحث Google خلاصتك مرة واحدة في اليوم ويفهرس المحتوى في غضون يومين عادةً.
• إذا كان من المتوقّع حصول تغيير في مدى توفّر أحد الإصدارات، استخدِم availabilityStarts وavailabilityEnds لضبط التواريخ الدقيقة. إذا لم يعُد الكيان متاحًا، يمكنك إزالته تمامًا.

تعريفات أنواع البيانات المنظَّمة

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

كيان DataFeed

يجب أن يتضمن كل ملف خلاصة بيانات على schema.org يتم تسليمه إلى Google كيانًا واحدًا من DataFeed في مستوى الجذر. يجب إدراج جميع كيانات Book وLibrary ضمن الحقل dataFeedElement في الكيان DataFeed.

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

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

كيان Book

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

Book (Work)

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

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

Book (Edition)

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

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

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

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

مثال على 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 روابط لمواضع معيّنة للوصول إلى الكتاب وبائع التجزئة الذي يخزّن نسخ عن الكتاب والمعايير التي يجب أن يستوفيها المستخدمون. وقد تتضمن المعايير حالة الاشتراك أو حالة تسجيل الدخول أو الموقع الجغرافي أو غيرها من الشروط المطلوبة للوصول إلى الكتاب.

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

مثال على 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 شبكة تعاونية مؤلّفة من أعضاء المكتبة.

Library (member)

تستخدم السمة member للكيان LibrarySystem الكيان Library (member). وتمثّل السمة Library (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/1003",
  "name": "Tokyo Metropolitan Central Library",
  "location": {
    "@type": "PostalAddress",
    "streetAddress": "７-13-5 Minamiazabu, Minato City",
    "addressLocality": "Tokyo",
    "postalCode": "106-0047",
    "addressCountry": "JP"
  }
}

مثال على ملف بتنسيق 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"
         }
      }
   ]
}