बुक ऐक्शन (Book) से जुड़ा स्ट्रक्चर्ड डेटा

बुक ऐक्शन, Google Search पर किताबों और लेखकों को खोजने का एक शुरुआती ज़रिया है. बुक ऐक्शन की मदद से, उपयोगकर्ता ऐसी किताबें तुरंत खरीद सकते हैं या किराये पर ले सकते हैं जो उन्हें सीधे Search के खोज नतीजों में मिलती हैं. उदाहरण के लिए, कोई उपयोगकर्ता शार्लेट्स वेब खोजता है, तो उसे ऐसे नतीजे दिख सकते हैं जिनमें किताब खरीदने या किराये पर लेने का विकल्प होता है. किताब बेचने वाले के तौर पर, यहां दिए गए स्ट्रक्चर्ड डेटा के स्कीमा का इस्तेमाल करके, Google को डेटा फ़ीड दिया जा सकता है. हम उपयोगकर्ताओं के लिए ReadAction उपलब्ध कराते हैं, जो कि किताबें खरीदने की सुविधा देता है. वहीं, BorrowAction किताबों को किराये पर लेने की सुविधा देता है.

नॉलेज पैनल में रीड ऐक्शन (किताब खरीदने) या बॉरो ऐक्शन (किराये पर लेने) का विकल्प होता है. इनका इस्तेमाल करके, किताबें खरीदी या किराये पर ली जा सकती हैं. आपके दिए गए लिंक पर क्लिक करके रीड ऐक्शन और बॉरो ऐक्शन के ज़रिए उपयोगकर्ता, नॉलेज पैनल और Google के दूसरे प्लैटफ़ॉर्म से सीधे आपकी वेबसाइट या ऐप्लिकेशन पर मौजूद किताब के वेबपेज पर पहुंच जाएंगे.

नॉलेज पैनल में, किताब बेचने वालों का क्रम, हर उपयोगकर्ता के हिसाब से अलग-अलग होता है और यह बदलता रहता है. इसका मतलब है कि हर उपयोगकर्ता को अलग क्रम दिखेगा. साथ ही, किसी एक उपयोगकर्ता को अलग-अलग समय पर इस क्रम में अंतर दिख सकता है. किताब बेचने वाली वेबसाइट के दिए गए क्रम में बदलाव, कई वजहों से होता है. उदाहरण के लिए, अगर कोई उपयोगकर्ता नॉलेज पैनल में, किताब बेचने वाली वेबसाइट के दिए लिंक पर अक्सर क्लिक करता है, तो हो सकता है कि उस वेबसाइट को क्रम में सबसे ऊपर रखा जाए. क्रम को कंट्रोल करने का कोई तरीका नहीं है.

शुरू करने का तरीका

बुक ऐक्शन की सुविधा को सही तरीके से लागू करने के लिए, आपको इस सुविधा के अलग-अलग तरह के स्ट्रक्चर्ड डेटा की जानकारी के हिसाब से अपना फ़ीड बनाना होगा. हालांकि, पहले आपको ये सेक्शन देखने होंगे:

• दिशा-निर्देश
• अपना फ़ीड बनाना
• डेटा फ़ीड की पुष्टि करने वाले टूल का इस्तेमाल करके, अपने फ़ीड की जांच करना
• अपने फ़ीड की फ़ाइल होस्ट करना
• समीक्षा के लिए अपने फ़ीड की फ़ाइल सबमिट करना
• ज़रूरत के हिसाब से अपना फ़ीड अपडेट करना

दिशा-निर्देश

यह पक्का करने के लिए कि Search में आपकी किताबें हर बार दिखें, आपको कुछ अहम जानकारी और मुख्य बातें पता होनी चाहिए. इसके अलावा, आपका फ़ीड, स्टैंडर्ड फ़ॉर्मैट के हिसाब से होना चाहिए.

ऐसा करने के लिए, स्ट्रक्चर्ड डेटा के लिए सामान्य दिशा-निर्देशों और Search पर कॉन्टेंट दिखाने के बुनियादी दिशा-निर्देशों के अलावा, यहां बताए गए दिशा-निर्देशों का पालन करें. दिशा-निर्देशों के बारे में जानें:

• किताबें और संस्करण
• लाइब्रेरी सिस्टम और लाइब्रेरी के सदस्य
• ISBN और इस्तेमाल किए जा सकने वाले अन्य आइडेंटिफ़ायर
• लिंक

किताबें और संस्करण

इस पूरे दस्तावेज़ में, जब भी हमने किसी किताब के बारे में बात की है, तो उसके लिए दो अलग-अलग शब्दों का इस्तेमाल हुआ है:

• किताब: किसी किताब के बारे में खास जानकारी. किसी किताब की विशेषताओं में शीर्षक, लेखक, और मूल भाषा जैसे मेटाडेटा खास तौर पर शामिल होते हैं.
• संस्करण: किसी किताब का प्रकाशित रूप. किसी संस्करण की विशेषताओं में प्रकाशन का साल, संस्करण का नाम, और इंटरनैशनल स्टैंडर्ड बुक नंबर (ISBN) जैसे मेटाडेटा खास तौर पर शामिल होते हैं.

उदाहरण के लिए, शार्लेट्स वेब एक किताब है, लेकिन उसकी हर वैराइटी नए संस्करण के तौर पर प्रकाशित होती है. ऐसी स्थिति में, शार्लेट्स वेब किताब का पहला संस्करण, दूसरा संस्करण, छोटा संस्करण, फ़्रेंच भाषा में अनुवाद किया गया संस्करण वगैरह हो सकता है.

फ़ीड में यह फ़र्क़ बहुत अहम होता है, क्योंकि सिस्टम को शायद इसके बारे में तुरंत पता न चले. दो तरह की Book इकाइयां होती हैं:

• Book (Work) एक "टॉप लेवल" की Book इकाई है:
  • workExample, Work की प्रॉपर्टी है और यह Book (Edition) के सिर्फ़ एक इंस्टेंस के बारे में ही बताती है.
  • हर Work के लिए कम से कम एक workExample होना चाहिए.
• Book (Edition) एक "लोअर लेवल" की Book इकाई है.

इससे यह पता चलता है कि एक किताब के कई संस्करण हो सकते हैं. हमारा सुझाव है कि जहां तक हो सके आप इन संस्करणों को एक साथ रखें. ऐसा करने से, Google के सिस्टम, किताब के बारे में सारी अहम जानकारी इस्तेमाल करके, Search में दिखा सकते हैं. अगर हो सके, तो आपको इन्हें किताब के अलग-अलग रिकॉर्ड में बांटना चाहिए, लेकिन हर किताब के रिकॉर्ड में ये चीज़ें होनी चाहिए:

• एक अलग @id.
• ISBN या इस्तेमाल किए जा सकने वाले किसी अन्य आइडेंटिफ़ायर वाला कम से कम एक संस्करण.

लाइब्रेरी सिस्टम और लाइब्रेरी के सदस्य

Library entity एक "टॉप लेवल" की Library इकाई है. यह एक छोटा ढांचा है, जिसमें LibrarySystem इकाई और इस लाइब्रेरी सिस्टम की "लोअर लेवल" वाली हर Library (member) इकाई शामिल है.

LibrarySystem इकाई एक वर्चुअल पता है और यह लाइब्रेरी के सदस्यों के सहयोग से चलने वाले किसी नेटवर्क के बारे में बताती है. उदाहरण के लिए, ऑस्टिन पब्लिक लाइब्रेरी को LibrarySystem इकाई माना जा सकता है. ऑस्टिन पब्लिक लाइब्रेरी की वेबसाइट खुद को सार्वजनिक लाइब्रेरी सिस्टम के तौर पर पेश करती है, जो कि टेक्सस के ऑस्टिन में सेवाएं मुहैया कराती है. इसमें ऑस्टिन पब्लिक लाइब्रेरी की 20 सहयोगी लाइब्रेरी या लाइब्रेरी के सदस्य शामिल हैं.

हर LibrarySystem इकाई के पास कम से कम एक Library (member) इकाई होनी चाहिए, भले ही वह लाइब्रेरी असल में किसी लाइब्रेरी सिस्टम का हिस्सा न हो. ऐसी स्थिति में, बुक ऐक्शन को लागू करने के लिए, वह लाइब्रेरी खुद के लाइब्रेरी सिस्टम की अकेली सदस्य होगी. बुक ऐक्शन को लागू करने के लिए, लाइब्रेरी के सदस्य का पता वर्चुअल नहीं होता है, बल्कि किसी एक पते पर मौजूद होता है. हालांकि, लाइब्रेरी सिस्टम के मामले में ऐसा नहीं होता है.

इसके उलट, हर Library (member) इकाई, कम से कम एक LibrarySystem इकाई से जुड़ी होनी चाहिए.

ISBN और इस्तेमाल किए जा सकने वाले अन्य आइडेंटिफ़ायर

जब Search, आपके फ़ीड डेटा का मिलान Google के डेटा से करता है, तो ISBN मुख्य पहचानकर्ता होता है. आपको जिन किताबों को Search के खोज नतीजों में दिखाना है उनके लिए, आपको ISBN या इस्तेमाल किया जा सकने वाला दूसरा आइडेंटिफ़ायर देना होगा. ऐसा नहीं करने पर, हो सकता है कि आपकी किताबें, Google के डेटा से मेल न खाएं और उन्हें खोज के नतीजों में न दिखाया जाए.

Google Search, ISBN-13 को प्राथमिकता देता है, लेकिन यहां बताए गए विकल्पों का भी इस्तेमाल किया जा सकता है:

• Online Computer Library Center (OCLC) नंबर
• Library of Congress Control Number (LCCN)
• JP ई-कोड

लिंक

यह पक्का करने के लिए कि लोग आसानी से आपकी किताबें ढूंढ पाएं, फ़ीड में दिए गए लिंक इन दिशा-निर्देशों के मुताबिक होने चाहिए:

• अगर आपके पास एक ही कॉन्टेंट के डुप्लीकेट पेज हैं, तो लिंक वह कैननिकल यूआरएल होना चाहिए जिसमें किताब का नाम और किताब के बारे में दूसरी जानकारी मौजूद हो.
• अगर कोई उपयोगकर्ता, रीड ऐक्शन या बॉरो ऐक्शन के लिए दिए गए लिंक पर क्लिक करता है, तो उपयोगकर्ता को सीधे उस पेज पर भेजा जाना चाहिए जिस पर किताब को खरीदा या किराये पर लिया जा सके. ध्यान रखें कि कार्रवाई करने वाले ऐसे लिंक न दें जो उपयोगकर्ताओं को उन पेजों पर भेजें जहां किताबों को खरीदने या किराये पर लेने के लिए, उन्हें और ज़्यादा लिंक पर क्लिक करना पड़े. उदाहरण के लिए, ऐसे लिंक नहीं देने चाहिए जो लोगों को खोज नतीजों के पेज या प्रॉडक्ट की खास जानकारी वाले पेज पर भेजें.

अपना फ़ीड बनाना

अगर आपकी साइट पर उपयोगकर्ताओं के लिए किताबें बेची जाती हैं, तो आपको Book फ़ीड को अपलोड करना होगा. अपने Google प्रतिनिधि से संपर्क करें और फ़ीड अपलोड करने के तरीके और इसे कहां अपलोड करना है, इसके बारे में जानें.

अगर आपकी साइट पर उपयोगकर्ताओं के लिए किताबें किराये पर दी जाती हैं, तो आपको दो अलग-अलग फ़ीड अपलोड करने होंगे: Book फ़ीड और Library फ़ीड. अपने Google प्रतिनिधि से संपर्क करें और फ़ीड अपलोड करने के तरीके और इसे कहां अपलोड करना है, इसके बारे में जानें.

फ़ाइल का साइज़, संख्या, और फ़ॉर्मैंट बताई गई ज़रूरी शर्तों के मुताबिक होना चाहिए.

ज़रूरी शर्तें:

• फ़ीड की फ़ाइल के साइज़ के लिए शर्तें:
  • फ़ीड की बिना कंप्रेस की हुई फ़ाइल का साइज़ 1 जीबी से कम होना चाहिए.
  • फ़ीड की कंप्रेस की जाने वाली फ़ाइल का साइज़ 1 जीबी से कम होना चाहिए. अगर फ़ीड की बिना कंप्रेस की गई फ़ाइल का साइज़ एक जीबी से ज़्यादा है, तो आपको उस फ़ाइल को कई फ़ाइलों में बांटना होगा.
• आप फ़ीड की फ़ाइलों को कंप्रेस कर सकते हैं. उन्हें zip, gz, tar, tar.gz, JAR, ar, arj, cpio या डंप आर्काइव के फ़ाइल फ़ॉर्मैट में कंप्रेस किया जाना चाहिए.
• अगर आपके पास फ़ीड की एक से ज़्यादा फ़ाइलें हैं, तो आप उन्हें उनके मौजूदा फ़ॉर्मैट में अपलोड कर सकते हैं. आप चाहें, तो उन्हें साइटमैप इंडेक्स फ़ाइल के हिस्से के रूप में भी शामिल कर सकते हैं.
• सिंगल फ़ीड की फ़ाइलों में .json फ़ाइल नाम वाला एक्सटेंशन होना चाहिए.

फ़ीड के कॉन्टेंट से जुड़ी ज़रूरी शर्तों का पालन करना

आपको फ़ीड के कॉन्टेंट से जुड़ी इन ज़रूरी शर्तों का पालन करना चाहिए:

• फ़ीड में कोई पुरानी इकाई नहीं होनी चाहिए. पुरानी इकाइयां ऐसी इकाइयां होती हैं जिनकी availabilityEnds के लिए सेट की गई तारीख निकल चुकी है या जो इकाइयां अब आपकी साइट पर उपलब्ध नहीं हैं.
• urlTemplate जैसे सभी डीप लिंक और url जैसे सभी यूआरएल, जिन्हें आपने फ़ीड में शामिल किया है वे प्रोडक्शन यूआरएल होने चाहिए. QA, डेवलपमेंट या किसी ऐसे तरह के यूआरएल का इस्तेमाल न करें जो प्रोडक्शन यूआरएल न हों.
• सभी यूआरएल, जैसे कि url, कैननिकल होने चाहिए.
• आपके फ़ीड की हर इकाई में ये प्रॉपर्टी मौजूद होनी चाहिए:
  • यूनीक आईडी: @id
  • यूनीक यूआरएल: url
  • यूनीक डीप लिंक: urlTemplate

डेटा फ़ीड की पुष्टि करने वाले टूल का इस्तेमाल करके, अपने फ़ीड की जांच करना

हम डेटा फ़ीड की पुष्टि करने वाले टूल पर सामान्य गड़बड़ियों और चेतावनियों को ठीक करने के लिए, समस्या को हल करने के इन तरीकों को अपनाने का सुझाव देते हैं:

• इस बात का ध्यान रखें कि आपने पुष्टि करें फ़ील्ड में सही विकल्प चुना हो. Book इकाई के लिए बुक ऐक्शन चुनें.

• देख लें कि @type की वैल्यू सही तरह से लिखी हो.
• देख लें कि @context की वैल्यू ठीक से सेट की गई हो. ReadAction और BorrowAction, दोनों के लिए "@context": "https://schema.org" सेट करें.

अपने फ़ीड की फ़ाइल होस्ट करना

जब आपके फ़ीड की फ़ाइल तैयार हो जाए, तो उसे किसी सुरक्षित जगह पर होस्ट करें. Google लगातार फ़ीड को फे़च करता है, ताकि आपका कॉन्टेंट अप-टू-डेट रहे.

होस्ट करने के तरीके

फ़ीड होस्ट करने के ये तरीके इस्तेमाल किए जा सकते हैं:

समीक्षा के लिए अपने फ़ीड की फ़ाइल सबमिट करना

Google Search में आपका कॉन्टेंट दिखे, इसके लिए Google की सहायता टीम आपके फ़ीड में मौजूद डीप लिंक की क्वालिटी की समीक्षा करती है. हमारा सुझाव है कि आप मैन्युअल तरीके से कुछ डीप लिंक की जांच करें, ताकि यह पक्का किया जा सके कि ये लिंक लोगों को उस पेज पर लेकर जा रहे हैं या नहीं जहां वे किताबों को खरीद सकते हैं या किराये पर ले सकते हैं.

अपने फ़ीड की समीक्षा का अनुरोध करने के लिए, यह जानकारी दें:

• होस्ट लोकेशन: आपके फ़ीड की फ़ाइल का यूआरएल.
• होस्ट की पुष्टि, अगर लागू हो, तो: पुष्टि करने वाले क्रेडेंशियल, ताकि Google आपके होस्ट लोकेशन से, फ़ीड की फ़ाइल पा सके.

ज़रूरत के हिसाब से अपना फ़ीड अपडेट करना

हमारा सुझाव है कि आप अपना फ़ीड हर दिन अपडेट करें, लेकिन यह इस बात पर निर्भर करता है कि आपका कैटलॉग कितनी बार बदलता है. यहां दी गई शर्तों और सलाह पर ध्यान दें:

• Google Search में फ़ीड को रीयल-टाइम में अपडेट नहीं किया जा सकता.
• Google Search आपके फ़ीड को दिन में एक बार फ़ेच करता है और आम तौर पर, कॉन्टेंट को दो दिनों में इंडेक्स करता है.
• अगर किसी वर्शन के उपलब्ध होने के समय में कोई बदलाव दिखता है, तो सटीक तारीख तय करने के लिए availabilityStarts और availabilityEnds का इस्तेमाल करें. अगर कोई इकाई अब उपलब्ध नहीं है, तो उसे पूरी तरह से हटा दें

अलग-अलग तरह के स्ट्रक्चर्ड डेटा की जानकारी

खोज के स्ट्रक्चर्ड नतीजों में दिखने के लिए, आपको अपने कॉन्टेंट में यहां दी गई ज़रूरी प्रॉपर्टी शामिल करनी होंगी. अपने कॉन्टेंट के बारे में ज़्यादा जानकारी जोड़ने के लिए, आप सुझाई गई प्रॉपर्टी भी शामिल कर सकते हैं. इससे लोगों को आपका कॉन्टेंट ढूंढने और उसका इस्तेमाल करने में आसानी होगी.

DataFeed इकाई

Google को उपलब्ध कराए जाने वाले schema.org डेटा फ़ीड की हर फ़ाइल में रूट लेवल पर DataFeed की एक इकाई होनी चाहिए. सभी Book और Library इकाइयां, DataFeed इकाई के dataFeedElement फ़ील्ड के तहत सूची में शामिल होनी चाहिए.

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": {...}
        }

एक से ज़्यादा workExample प्रॉपर्टी वाले Book (Edition) का उदाहरण:

"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 (पहचानकर्ता)

Edition की identifier प्रॉपर्टी, 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"
    }]

ReadAction Book फ़ीड की JSON फ़ाइल का उदाहरण

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

BorrowAction Book फ़ीड की JSON फ़ाइल का उदाहरण

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

एक से ज़्यादा EntryPoint प्रॉपर्टी वाले ReadAction का उदाहरण:

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

एक से ज़्यादा EntryPoint प्रॉपर्टी वाले 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"
      ]
    },
    {
      "@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 इकाई और LibrarySystem के हर एक लोअर लेवल की Library (member) इकाई शामिल है.

Library फ़ीड, Book फ़ीड से अलग होता है. इसलिए, कोई भी Library फ़ीड जिसे आप लागू करेंगे वह आपके Book फ़ीड से पूरी तरह अलग होना चाहिए. ज़्यादा जानकारी के लिए, अपना फ़ीड बनाना देखें.

LibrarySystem

LibrarySystem इकाई, लाइब्रेरी के सदस्यों के सहयोगी नेटवर्क के बारे में बताती है.

Library (member)

LibrarySystem इकाई की member प्रॉपर्टी, 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"
  }
}

LibrarySystem फ़ीड की JSON फ़ाइल का उदाहरण

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