बुक ऐक्शन (Book
) से जुड़ा स्ट्रक्चर्ड डेटा
बुक ऐक्शन, Google Search पर किताबों और लेखकों को खोजने का एक शुरुआती ज़रिया है. बुक ऐक्शन की मदद से,
उपयोगकर्ता ऐसी किताबें तुरंत खरीद सकते हैं या किराये पर ले सकते हैं जो उन्हें सीधे Search के खोज नतीजों में मिलती हैं.
उदाहरण के लिए, कोई उपयोगकर्ता शार्लेट्स वेब खोजता है, तो उसे
ऐसे नतीजे दिख सकते हैं जिनमें किताब खरीदने या किराये पर लेने का विकल्प होता है. किताब बेचने वाले के तौर पर, यहां दिए गए स्ट्रक्चर्ड डेटा के स्कीमा का इस्तेमाल करके, Google
को डेटा फ़ीड दिया जा सकता है. हम उपयोगकर्ताओं के लिए
ReadAction
उपलब्ध कराते हैं, जो कि किताबें खरीदने की सुविधा देता है. वहीं, BorrowAction
किताबों को किराये पर लेने की सुविधा
देता है.
![Search के नतीजों में किताबें खोजने से जुड़ी कार्रवाई](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/books01.png?authuser=6&hl=hi)
नॉलेज पैनल में रीड ऐक्शन (किताब खरीदने) या बॉरो ऐक्शन (किराये पर लेने) का विकल्प होता है. इनका इस्तेमाल करके, किताबें खरीदी या किराये पर ली जा सकती हैं. आपके दिए गए लिंक पर क्लिक करके रीड ऐक्शन और बॉरो ऐक्शन के ज़रिए उपयोगकर्ता, नॉलेज पैनल और 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 Cloud Storage | स्टोरेज ऑब्जेक्ट व्यूअर की अनुमति | |
एचटीटीपीएस | उपयोगकर्ता नाम+पासवर्ड या एचटीटीपी क्लाइंट प्रमाणपत्र | |
एसएफ़टीपी | पासवर्ड, कुंजी+वाक्यांश या दोनों | |
AWS S3 | कुंजी आईडी+ऐक्सेस कुंजी |
समीक्षा के लिए अपने फ़ीड की फ़ाइल सबमिट करना
Google Search में आपका कॉन्टेंट दिखे, इसके लिए Google की सहायता टीम आपके फ़ीड में मौजूद डीप लिंक की क्वालिटी की समीक्षा करती है. हमारा सुझाव है कि आप मैन्युअल तरीके से कुछ डीप लिंक की जांच करें, ताकि यह पक्का किया जा सके कि ये लिंक लोगों को उस पेज पर लेकर जा रहे हैं या नहीं जहां वे किताबों को खरीद सकते हैं या किराये पर ले सकते हैं.
अपने फ़ीड की समीक्षा का अनुरोध करने के लिए, यह जानकारी दें:
- होस्ट लोकेशन: आपके फ़ीड की फ़ाइल का यूआरएल.
- होस्ट की पुष्टि, अगर लागू हो, तो: पुष्टि करने वाले क्रेडेंशियल, ताकि Google आपके होस्ट लोकेशन से, फ़ीड की फ़ाइल पा सके.
ज़रूरत के हिसाब से अपना फ़ीड अपडेट करना
हमारा सुझाव है कि आप अपना फ़ीड हर दिन अपडेट करें, लेकिन यह इस बात पर निर्भर करता है कि आपका कैटलॉग कितनी बार बदलता है. यहां दी गई शर्तों और सलाह पर ध्यान दें:
- Google Search में फ़ीड को रीयल-टाइम में अपडेट नहीं किया जा सकता.
- Google Search आपके फ़ीड को दिन में एक बार फ़ेच करता है और आम तौर पर, कॉन्टेंट को दो दिनों में इंडेक्स करता है.
- अगर किसी वर्शन के उपलब्ध होने के समय में कोई बदलाव दिखता है, तो सटीक तारीख तय करने के लिए
availabilityStarts
औरavailabilityEnds
का इस्तेमाल करें. अगर कोई इकाई अब उपलब्ध नहीं है, तो उसे पूरी तरह से हटा दें
अलग-अलग तरह के स्ट्रक्चर्ड डेटा की जानकारी
खोज के स्ट्रक्चर्ड नतीजों में दिखने के लिए, आपको अपने कॉन्टेंट में यहां दी गई ज़रूरी प्रॉपर्टी शामिल करनी होंगी. अपने कॉन्टेंट के बारे में ज़्यादा जानकारी जोड़ने के लिए, आप सुझाई गई प्रॉपर्टी भी शामिल कर सकते हैं. इससे लोगों को आपका कॉन्टेंट ढूंढने और उसका इस्तेमाल करने में आसानी होगी.
DataFeed इकाई
Google को उपलब्ध कराए जाने वाले schema.org डेटा फ़ीड की हर फ़ाइल में रूट लेवल पर
DataFeed
की एक इकाई होनी चाहिए. सभी
Book
और
Library
इकाइयां, DataFeed
इकाई के
dataFeedElement
फ़ील्ड के तहत सूची में शामिल होनी चाहिए.
Google पर काम करने वाली प्रॉपर्टी ये हैं:
ज़रूरी प्रॉपर्टी | |
---|---|
@context |
|
@type |
|
dataFeedElement |
किसी एक
{ "@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" } |
dateModified |
ISO 8601 फ़ॉर्मैट में फ़ीड के पिछली बार अपडेट होने की तारीख और समय. |
Book
इकाई
हालांकि, Book
के बारे में पूरी जानकारी schema.org/Book पर उपलब्ध है, इसलिए आपको सिर्फ़ इन प्रॉपर्टी के बारे में जानना होगा. आपको अपने फ़ीड में शामिल हर किताब के लिए, ज़रूरी प्रॉपर्टी तय करनी होंगी. अपने कॉन्टेंट के बारे में ज़्यादा जानकारी देने के लिए,
आप सुझाई गई प्रॉपर्टी के बारे में भी बता सकते हैं. इससे लोगों को आपका कॉन्टेंट ढूंढने और उसका इस्तेमाल करने में आसानी होगी.
Book
(Work
)
यह Book
इकाई, एक तरह की टॉप लेवल इकाई है. यह एक किताब के बारे में बताता है.
Google पर काम करने वाली प्रॉपर्टी ये हैं:
ज़रूरी प्रॉपर्टी | |
---|---|
@context |
|
@id |
यूआरएल फ़ॉर्मैट में, किताब का दुनिया भर में मान्य यूनीक आईडी. यह आपके संगठन के लिए अलग होना चाहिए. यह आईडी समय के साथ बदलना नहीं चाहिए. यूआरएल फ़ॉर्मैट का सुझाव दिया जाता है. हालांकि, यह ज़रूरी नहीं है. ज़रूरी नहीं है कि यह लिंक काम करता हो. |
@type |
|
author |
किताब का (के) लेखक. |
name |
किताब का नाम. |
url |
आपकी वेबसाइट का वह यूआरएल जहां किताब को दिखाया गया है या उसके बारे में बताया गया है. यह लिंक Google के डेटाबेस में मौजूद कॉन्टेंट के साथ आपके फ़ीड के कॉन्टेंट का सटीक मेल करने में मदद करता है. यह असल लैंडिंग पेज पर जाने के लिए, Google Search, |
workExample |
किताब का (के) संस्करण. |
सुझाई गई प्रॉपर्टी | |
---|---|
sameAs |
रेफ़रंस पेज का यूआरएल, जो किताब की पहचान बताता है. जैसे, किताब के लिए Wikipedia, Wikidata, VIAF या Library of Congress पेज. |
Book
(Edition
)
workExample
प्रॉपर्टी इस Book
इकाई का इस्तेमाल करती है. यह किसी किताब का संस्करण है.
Google पर काम करने वाली प्रॉपर्टी ये हैं:
ज़रूरी प्रॉपर्टी | |
---|---|
@id |
यूआरएल फ़ॉर्मैट में, किताब का दुनिया भर में मान्य यूनीक आईडी. यह आपके संगठन के लिए अलग होना चाहिए. यह आईडी समय के साथ बदलना नहीं चाहिए. यूआरएल फ़ॉर्मैट का सुझाव दिया जाता है. हालांकि, यह ज़रूरी नहीं है. ज़रूरी नहीं है कि यह लिंक काम करता हो. |
@type |
|
bookFormat |
संस्करण का फ़ॉर्मैट. इसकी वैल्यू इनमें से एक होनी चाहिए:
|
inLanguage |
संस्करण में कॉन्टेंट की मुख्य भाषा. ISO 639-1 alpha-2 कोड की सूची में दिए गए दो अक्षरों वाले कोड में से कोई एक इस्तेमाल करें. |
isbn |
संस्करण का ISBN-13. अगर आपके पास ISBN-10 है, तो उसे ISBN-13 में बदलें. |
potentialAction |
उपयोगकर्ताओं को, किताब खरीदने या डाउनलोड करने के लिए ट्रिगर करने वाला ऐक्शन. ज़्यादा
जानकारी के लिए, |
सुझाई गई प्रॉपर्टी | |
---|---|
author |
संस्करण का (के) लेखक. |
bookEdition |
किताब के संस्करण की जानकारी. उदाहरण के लिए, |
datePublished |
YYYY-MM-DD या YYYY फ़ॉर्मैट में संस्करण के प्रकाशन की तारीख. यह या तो चुनी गई एक तारीख हो सकती है या सिर्फ़ चुना गया कोई साल. |
identifier |
वह बाहरी या अन्य आईडी जो साफ़ तौर से इस संस्करण की पहचान बताता है. एक से ज़्यादा,
पहचानकर्ता इस्तेमाल किए जा सकते हैं. ज़्यादा जानकारी के लिए,
यह प्रॉपर्टी दोबारा इस्तेमाल की जा सकती है. |
name |
संस्करण का शीर्षक. इसका इस्तेमाल सिर्फ़ तब करें, जब संस्करण का शीर्षक, किताब के शीर्षक से अलग हो. |
sameAs |
रेफ़रंस वाले वेब पेज का यूआरएल, जो साफ़ तौर पर संस्करण की पहचान बताता है. उदाहरण के लिए, इस संस्करण के लिए एक Wikipedia पेज. |
url |
आपकी वेबसाइट का वह यूआरएल जहां संस्करण दिखाया गया है या उसके बारे में बताया गया है. यह
|
उदाहरण 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
इकाई का इस्तेमाल करती है.
ज़रूरी प्रॉपर्टी | |
---|---|
@type |
|
name |
व्यक्ति या संगठन का नाम. |
सुझाई गई प्रॉपर्टी | |
---|---|
sameAs |
रेफ़रंस वाले वेब पेज का यूआरएल, जो साफ़ तौर पर उस व्यक्ति या संगठन की पहचान बताता है. उदाहरण के लिए, किसी व्यक्ति या संगठन की जानकारी देने वाला Wikipedia पेज. |
उदाहरण 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
इकाई का इस्तेमाल करती है.
ज़रूरी प्रॉपर्टी | |
---|---|
@type |
|
propertyID |
आईडी का टाइप. जैसा, ISBN और इस्तेमाल किए जा सकने वाले अन्य पहचानकर्ता में बताया गया है, यह इनमें से कोई एक होना चाहिए:
|
value |
आईडी की वैल्यू. वह बाहरी आईडी जो साफ़ तौर से इस संस्करण की पहचान बताता है. बाहरी आईडी के सभी बिना अंक वाले प्रीफ़िक्स हटाएं. |
उदाहरण के लिए, 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
, किताब को ऐक्सेस करने वाले आपके डीप लिंक, किताब का स्टॉक करने वाले खुदरा विक्रेता, और उन शर्तों के बारे में बताता है जिन्हें उपयोगकर्ताओं को पूरा करना ज़रूरी है. इन शर्तों में सदस्यता की स्थिति,
लॉगिन की स्थिति, जगह की जानकारी या किताब को ऐक्सेस करने के लिए अन्य ज़रूरी बातें शामिल हो सकती हैं.
ज़रूरी प्रॉपर्टी | |
---|---|
@type |
|
expectsAcceptanceOf |
इस इकाई को ऐक्सेस करने वाले उपयोगकर्ता के लिए ज़रूरी शर्तें. अगर एक से ज़्यादा यह प्रॉपर्टी दोबारा इस्तेमाल की जा सकती है. |
expectsAcceptanceOf.@type |
|
expectsAcceptanceOf.category |
|
expectsAcceptanceOf.eligibleRegion |
वह देश जो इस यह प्रॉपर्टी दोबारा इस्तेमाल की जा सकती है. |
expectsAcceptanceOf.eligibleRegion.@type |
|
expectsAcceptanceOf.eligibleRegion.name |
ISO 3166-1 alpha-2 फ़ॉर्मैट में देश का कोड. |
target |
आपके डीप लिंक में, इसके साथ काम करने वाले प्लैटफ़ॉर्म की जानकारी शामिल है. अलग-अलग प्लैटफ़ॉर्म सेट के लिए, अलग-अलग डीप लिंक बनाने वाली एक से ज़्यादा यह प्रॉपर्टी दोबारा इस्तेमाल की जा सकती है. |
target.@type |
|
target.actionPlatform |
यह डीप लिंक जिस (जिन) प्लैटफ़ॉर्म के लिए मान्य है. इनमें से किसी एक वैल्यू का इस्तेमाल करें:
यह प्रॉपर्टी दोबारा इस्तेमाल की जा सकती है. |
target.urlTemplate |
वह लिंक जो उपयोगकर्ताओं को सीधे आपकी किताब के लैंडिंग पेज के कॉन्टेंट पर ले जाता है. |
सुझाई गई प्रॉपर्टी | |
---|---|
expectsAcceptanceOf.availabilityEnds |
वह समय जिसके बाद किताब उपलब्ध नहीं होगी. इसका इस्तेमाल वह सटीक समय तय करने के लिए किया जा सकता है जिसके बाद उपयोगकर्ताओं को यह किताब नहीं दिखेगी. |
expectsAcceptanceOf.availabilityStarts |
वह समय जब से किताब उपलब्ध होगी. इसका इस्तेमाल वह सटीक समय तय करने के लिए किया जा सकता है जब से उपयोगकर्ताओं को यह किताब दिख सकती है. |
expectsAcceptanceOf.price |
किताब की कीमत. इसका इस्तेमाल तब किया जाता है, जब |
expectsAcceptanceOf.priceCurrency |
कीमत, तीन अक्षर वाले ISO 4217 फ़ॉर्मैट में होनी चाहिए. |
उदाहरण के लिए, ReadAction
:
"potentialAction": { "@type": "ReadAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/purchase?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] }, "expectsAcceptanceOf": { "@type": "Offer", "category": "purchase", "price": "9.99", "priceCurrency": "USD", "availabilityStarts": "2018-04-01T11:01:00-04:00", "availabilityEnds": "2018-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "US" } } }
एक से ज़्यादा 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
, किताब को ऐक्सेस करने वाले आपके डीप लिंक, किताब का स्टॉक करने वाले खुदरा विक्रेता, और उन शर्तों के बारे में बताता है जिन्हें उपयोगकर्ताओं को पूरा करना ज़रूरी है. इन शर्तों में सदस्यता की स्थिति,
लॉगिन की स्थिति, जगह की जानकारी या किताब को ऐक्सेस करने के लिए अन्य ज़रूरी बातें शामिल हो सकती हैं.
ज़रूरी प्रॉपर्टी | |
---|---|
@type |
|
lender |
लाइब्रेरी सिस्टम, जो इस संस्करण का ऐक्सेस देता है. |
lender.@id |
|
lender.@type |
|
target |
आपके डीप लिंक में, इसके साथ काम करने वाले प्लैटफ़ॉर्म की जानकारी शामिल है. अगर आप अलग-अलग प्लैटफ़ॉर्म सेट के लिए, डीप लिंक की जानकारी देना चाहते हैं, तो यह प्रॉपर्टी दोबारा इस्तेमाल की जा सकती है. |
target.@type |
|
target.actionPlatform |
यह डीप लिंक जिस (जिन) प्लैटफ़ॉर्म के लिए मान्य है. इनमें से किसी एक वैल्यू का इस्तेमाल करें:
यह प्रॉपर्टी दोबारा इस्तेमाल की जा सकती है. |
target.urlTemplate |
वह लिंक जो उपयोगकर्ताओं को सीधे आपकी किताब के लैंडिंग पेज के कॉन्टेंट पर ले जाता है. |
उदाहरण 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
इकाई, लाइब्रेरी के सदस्यों के सहयोगी नेटवर्क के बारे में बताती है.
ज़रूरी प्रॉपर्टी | |
---|---|
@context
|
Text
|
@id
|
URL
यूआरएल के तौर पर, दुनिया भर में पहचाना जाने वाला लाइब्रेरी सिस्टम का यूनीक आईडी. यह आईडी समय के साथ बदलना नहीं चाहिए. इसे एक अधूरी स्ट्रिंग के तौर पर देखा जाता है. ज़रूरी नहीं है कि यह लिंक काम करता हो. |
@type
|
Text
|
additionalProperty
|
PropertyValue
लाइब्रेरी टाइप के बारे में बताने वाली अन्य प्रॉपर्टी. |
additionalProperty.@type
|
Text
|
additionalProperty.name
|
Text
|
additionalProperty.value
|
Text
लाइब्रेरी टाइप इनमें से किसी एक वैल्यू का इस्तेमाल करें:
|
member
|
Library
लाइब्रेरी सिस्टम का (के) सदस्य. |
name
|
Text
लाइब्रेरी सिस्टम का नाम. उदाहरण के लिए,
|
url
|
URL
वह यूआरएल जहां लाइब्रेरी सिस्टम को दिखाया गया है या उसके बारे में बताया गया है. Google Search, इस लिंक का इस्तेमाल आपके फ़ीड के कॉन्टेंट का, Google के डेटाबेस में मौजूद कॉन्टेंट से मेल करने के लिए करता है. असल
लैंडिंग पेज के लिए, Google Search,
|
Library
(member
)
LibrarySystem
इकाई की member
प्रॉपर्टी, Library (member)
इकाई का इस्तेमाल करती है.
Library (member)
, किसी दी गई लाइब्रेरी सिस्टम के सिंगल लाइब्रेरी के सदस्य के बारे में बताता है.
ज़रूरी प्रॉपर्टी | |
---|---|
@id
|
URL
यूआरएल
फ़ॉर्मैट के तौर पर, दुनिया भर में पहचानी जाने वाली लाइब्रेरी की ब्रांच का यूनीक आईडी. यह आईडी समय के साथ बदलना नहीं चाहिए. इसे एक अधूरी स्ट्रिंग के तौर पर देखा जाता है. ज़रूरी नहीं है कि यह लिंक काम करता हो. |
@type
|
Text
|
location
|
PostalAddress
लाइब्रेरी की ब्रांच का पता. सभी प्रॉपर्टी हर देश पर लागू नहीं होती हैं. आप अपनी लाइब्रेरी के पतों पर ज़्यादा से ज़्यादा प्रॉपर्टी लागू कर सकते हैं. अमेरिका { "@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": "7-13-5 Minamiazabu, Minato City", "addressLocality": "Tokyo", "postalCode": "106-0047", "addressCountry": "JP" } } |
location.@type
|
Text
|
location.addressCountry
|
Text
ISO 3166-1 फ़ॉर्मैट में देश का कोड. उदाहरण के लिए, |
location.addressLocality
|
Text
शहर. उदाहरण के लिए,
|
location.addressRegion
|
Text
क्षेत्र. उदाहरण के लिए, |
location.postalCode
|
Text
पिन कोड. उदाहरण के लिए,
|
location.streetAddress
|
Text
मोहल्ले का पता. उदाहरण के लिए,
|
name
|
Text
लाइब्रेरी की ब्रांच का नाम. |
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" } } ] }