كتاب

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

أمثلة

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

<html>
  <head>
    <title>The Catcher in the Rye</title>
    <script type="application/ld+json">
    {
      "@context":"https://schema.org",
      "@type":"Book",
      "name" : "The Catcher in the Rye",
      "author": {
        "@type":"Person",
        "name":"J.D. Salinger"
      },
      "url" : "http://www.barnesandnoble.com/store/info/offer/JDSalinger",
      "workExample" : [{
        "@type": "Book",
        "isbn": "031676948",
        "bookEdition": "2nd Edition",
        "bookFormat": "https://schema.org/Hardcover",
        "potentialAction":{
        "@type":"ReadAction",
        "target":
          {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.barnesandnoble.com/store/info/offer/0316769487?purchase=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "Price":6.99,
            "priceCurrency":"USD",
            "eligibleRegion" : {
              "@type":"Country",
              "name":"US"
            },
            "availability": "https://schema.org/InStock"
          }
        }
      },{
        "@type": "Book",
        "isbn": "031676947",
        "bookEdition": "1st Edition",
        "bookFormat": "https://schema.org/EBook",
        "potentialAction":{
        "@type":"ReadAction",
        "target":
          {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.barnesandnoble.com/store/info/offer/031676947?purchase=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "Price":1.99,
            "priceCurrency":"USD",
            "eligibleRegion" : {
              "@type":"Country",
              "name":"UK"
            },
            "availability": "https://schema.org/InStock"
          }
        }
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

الإرشادات

إلى جانب الإرشادات العامة للبيانات المنظَّمة، اتّبِع الإرشادات الإضافية التالية التي تخص الكُتب وإجراءات القراءة:

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

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

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

كتاب

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

الخصائص المطلوبة
`author`	`Person` تمثل هذه الخاصية مؤلِّف الكتاب. ويجب تقديم قيمة Person معيّنة لكل مؤلف تذكره. راجع Person.
`name`	`Text` تمثل هذه الخاصية عنوان الكتاب. في حال تقديم عدة إصدارات، استخدِم عنوان إصدار الكتاب.
`url`	`URL` تمثل هذه الخاصية عنوان URL لصفحة الكتاب على موقعك الإلكتروني. وقد تُدرج الصفحة جميع الإصدارات المتاحة.
`workExample`	`Book` تمثل هذه الخاصية إصدارات هذا الكتاب. راجِع الخصائص الفرعية لـ `workExample`.

الخصائص المقترَحة
`@id`	`URL` تمثل هذه الخاصية معرّفًا فريدًا عالميًا للعمل بتنسيق عنوان URL. يجب أن يكون المعرّف ثابتًا ولا يتغير بمرور الوقت. تتم معاملة عنوان URL كسلسلة مبهمة، ولا يلزم أن يؤدي إلى صفحة ويب فعلية.
`sameAs`	`URL` تمثل هذه الخاصية صفحة مرجعية تشير بوضوح إلى هوية الكتاب، مثل عنوان URL لصفحة الكتاب على "ويكيبيديا" أو Freebase أو الموقع الإلكتروني الرسمي.

البلد

تحدّد المجموعة الفرعية للخاصية Offer رمز البلد المُكوَن من حرفين والذي يكون Offer فيه ساريًا.

الخصائص المطلوبة
`name`	`Text` تمثل هذه الخاصية اسم البلد وفقًا للمعيار alpha-2 3166.

EntryPoint

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

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

الخصائص المطلوبة
`actionPlatform`	`Text` تمثل هذه الخاصية الأنظمة الأساسية التي يعمل عليها الرابط. ويمكنك تحديد واحد أو أكثر مما يلي: http://schema.org/DesktopWebPlatform: للعمل على متصفحات الويب على أجهزة سطح المكتب http://schema.org/MobileWebPlatform: للعمل على متصفحات الويب على الأجهزة الجوّالة http://schema.org/AndroidPlatform: للعمل على تطبيق محلي لنظام التشغيل Android http://schema.org/IOSPlatform: للعمل على تطبيق محلي لنظام التشغيل iOS يمكن حذف هذه الخاصية للروابط التي تؤدي إلى مواضع معيّنة باستخدام المخطط المخصّص لنظام التشغيل Android.
`urlTemplate`	`URL` تمثل هذه الخاصية الروابط التي تؤدي إلى المحتوى.

actionPlatform

Text

تمثل هذه الخاصية الأنظمة الأساسية التي يعمل عليها الرابط. ويمكنك تحديد واحد أو أكثر مما يلي:

http://schema.org/DesktopWebPlatform: للعمل على متصفحات الويب على أجهزة سطح المكتب
http://schema.org/MobileWebPlatform: للعمل على متصفحات الويب على الأجهزة الجوّالة
http://schema.org/AndroidPlatform: للعمل على تطبيق محلي لنظام التشغيل Android
http://schema.org/IOSPlatform: للعمل على تطبيق محلي لنظام التشغيل iOS

يمكن حذف هذه الخاصية للروابط التي تؤدي إلى مواضع معيّنة باستخدام المخطط المخصّص لنظام التشغيل Android.

urlTemplate

URL

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

Offer

تحدّد الخاصية Offer أحكام وشروط الشراء.

الخصائص المطلوبة
`price`	`Number` تمثل هذه الخاصية سعر المنتج في العرض، ويتم تعيين العملة في الخاصية priceCurrency.
`priceCurrency`	`Text` تمثل هذه الخاصية العملة (بالتنسيق ISO 4217 المُكوَن من 3 أحرف).

الخصائص المقترَحة
`@id`	`URL` تمثل هذه الخاصية المعرّف الفريد العالمي للعرض.
`availability`	`ItemAvailability` تمثل هذه الخاصية مدى توفر هذه السلعة، مثل InStock أو OutOfStock أو PreOrder.
`eligibleRegion`	`Country` تمثل هذه الخاصية البلدان التي يكون فيها العرض ساريًا.
`ineligibleRegion`	`Country` تمثّل هذه الخاصية البلدان التي يكون العرض فيها غير سارٍ (قد تلغي هذه الخاصية المناطق السارية إذا ظهر بلد واحد في كل من مجموعة المناطق السارية ومجموعة المناطق غير السارية).

Person

تستخدم Google النوع Person للمؤلِّف.

الخصائص المطلوبة
`name`	`Text` تمثل هذه الخاصية اسم الشخص.

الخصائص المقترَحة
`sameAs`	`URL` تمثل هذه الخاصية صفحة مرجعية تشير بوضوح إلى سمات السلعة، مثل عنوان URL لصفحة السلعة على "ويكيبيديا" أو Freebase أو الموقع الإلكتروني الرسمي.

ReadAction

تحدّد الخصائص ReadAction كلاً من النظام الأساسي للمحتوى وحالات حدوث الإجراء، مثل شراء المحتوى قبل بدء القراءة.

الخصائص المطلوبة
`expectsAcceptanceOf`	`Offer` تمثل هذه الخاصية حاوية لحالات الإجراء.
`target`	`EntryPoint` تمثل هذه الخاصية حاوية للإجراء الهدف.

workExample

تحدّد هذه الخاصية إما إصدارًا معينًا من العمل المكتوب أو مجلد العمل.

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

الخصائص المطلوبة
`bookFormat`	`BookFormatType` تمثل هذه الخاصية تنسيق الكتاب باستخدام قيمة أو أكثر من القيم التالية: `EBook` `Hardcover` `Paperback` `AudioBook`
`isbn`	`Text` تمثل هذه الخاصية رقم ISBN للمجلد. ويمكن أن يكون رقم ISBN مكونًا من 10 أعداد أو 13 عددًا، لكننا ننصح باستخدام 13 عددًا إن أمكن. استخدِم بدلاً من هذا رقم ISBN للكتاب المطبوع في حال غياب رقم ISBN للإصدار محل الوصف، مثل إصدار Kindle.
`potentialAction`	`ReadAction` تمثل هذه الخاصية إجراءات القراءة للكتاب.

bookFormat

BookFormatType

تمثل هذه الخاصية تنسيق الكتاب باستخدام قيمة أو أكثر من القيم التالية:

EBook
Hardcover
Paperback
AudioBook

isbn

Text

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

potentialAction

ReadAction

تمثل هذه الخاصية إجراءات القراءة للكتاب.

الخصائص المقترَحة
`@id`	`URL` تمثل هذه الخاصية المعرّف الفريد العالمي للمجلد في شكل عنوان URL. ويجب أن يكون المعرّف ثابتًا ولا يتغير مع مرور الوقت. يجب أيضًا أن يكون مختلفًا عن المعرّف المُستخدَم للكتاب. تتم معاملة عنوان URL كسلسلة مبهمة، ولا يلزم أن يكون رابطًا عاملاً.
`author`	`Person` تمثل هذه الخاصية مؤلِّف المجلد. وتُستخدَم هذه الخاصية فقط إذا كان مؤلف المجلد مختلفًا عن مؤلف الكتاب المعنيّ. ويجب تقديم قيمة Person واحدة لكل مؤلِّف.
`bookEdition`	`Text` تمثل هذه الخاصية إصدار الكتاب.
datePublished	`Date` تمثل هذه الخاصية تاريخ النشر الأول لهذا المجلد.
`name`	`Text` تمثل هذه الخاصية عنوان المجلد. وتُستخدَم هذه الخاصية فقط لعنوان المجلد إذا كان مختلفًا عن الكتاب.
`sameAs`	`URL` تمثل هذه الخاصية صفحة مرجعية تشير بوضوح إلى سمات السلعة، مثل عنوان URL لصفحة السلعة على "ويكيبيديا" أو Freebase أو الموقع الإلكتروني الرسمي.
`url`	`URL` تمثل هذه الخاصية عنوان URL لهذا الإصدار، إنْ وجد.