Volume
कलेक्शन का इस्तेमाल, किताबों की अलमारी का कॉन्टेंट खोजने या उसकी लिस्टिंग करने के लिए किया जाता है. इस कलेक्शन को सिर्फ़ पढ़ा जा सकता है.तरीके
यहां दिए गए तरीके, वॉल्यूम के सार्वजनिक डेटा पर लागू होते हैं. साथ ही, इनके लिए पुष्टि करने की ज़रूरत नहीं होती.
books.volumes.listbooks.volumes.get
यह तरीका, वॉल्यूम के निजी "मेरी लाइब्रेरी" व्यू पर लागू होता है. इसके लिए, पुष्टि करना ज़रूरी है.
books.mylibrary.bookshelves.volumes.list- पाएं
- आईडी के आधार पर वॉल्यूम रिसॉर्स को फ़ेच करता है.
- list
- किताब की खोज करता है.
संसाधन के तौर पर दिखाए जाने वाले आइटम
वॉल्यूम से, किसी किताब या पत्रिका के बारे में Google Books पर मौजूद जानकारी का पता चलता है. इसमें टाइटल और लेखक जैसे मेटाडेटा के साथ-साथ, आपके हिसाब से बनाया गया डेटा भी शामिल होता है. जैसे, कि इसे खरीदा गया है या नहीं. (LITE प्रोजेक्शन में उपलब्ध वॉल्यूम फ़ील्ड नीचे नोट किए गए हैं).
{ "kind": "books#volume", "id": string, "etag": string, "selfLink": string, "volumeInfo": { "title": string, "subtitle": string, "authors": [ string ], "publisher": string, "publishedDate": string, "description": string, "industryIdentifiers": [ { "type": string, "identifier": string } ], "pageCount": integer, "dimensions": { "height": string, "width": string, "thickness": string }, "printType": string, "mainCategory": string, "categories": [ string ], "averageRating": double, "ratingsCount": integer, "contentVersion": string, "imageLinks": { "smallThumbnail": string, "thumbnail": string, "small": string, "medium": string, "large": string, "extraLarge": string }, "language": string, "previewLink": string, "infoLink": string, "canonicalVolumeLink": string }, "userInfo": { "review": mylibrary.reviews Resource, "readingPosition": mylibrary.readingpositions Resource, "isPurchased": boolean, "isPreordered": boolean, "updated": datetime }, "saleInfo": { "country": string, "saleability": string, "onSaleDate": datetime, "isEbook": boolean, "listPrice": { "amount": double, "currencyCode": string }, "retailPrice": { "amount": double, "currencyCode": string }, "buyLink": string }, "accessInfo": { "country": string, "viewability": string, "embeddable": boolean, "publicDomain": boolean, "textToSpeechPermission": string, "epub": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "pdf": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "webReaderLink": string, "accessViewStatus": string, "downloadAccess": { "kind": "books#downloadAccessRestriction", "volumeId": string, "restricted": boolean, "deviceAllowed": boolean, "justAcquired": boolean, "maxDownloadDevices": integer, "downloadsAcquired": integer, "nonce": string, "source": string, "reasonCode": string, "message": string, "signature": string } }, "searchInfo": { "textSnippet": string } }
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
kind |
string |
किसी वॉल्यूम के लिए रिसॉर्स टाइप. (LITE प्रोजेक्शन में.) | |
id |
string |
किसी वॉल्यूम के लिए यूनीक आइडेंटिफ़ायर. (LITE प्रोजेक्शन में.) | |
etag |
string |
वॉल्यूम रिसॉर्स के किसी खास वर्शन के लिए ओपेक आइडेंटिफ़ायर. (LITE प्रोजेक्शन में) | |
selfLink |
string |
इस संसाधन का यूआरएल. (LITE प्रोजेक्शन में.) | |
volumeInfo |
object |
वॉल्यूम के बारे में सामान्य जानकारी. | |
volumeInfo.title |
string |
वॉल्यूम का टाइटल. (LITE प्रोजेक्शन में.) | |
volumeInfo.subtitle |
string |
वॉल्यूम का सबटाइटल. (LITE प्रोजेक्शन में.) | |
volumeInfo.authors[] |
list |
इस वॉल्यूम के लेखकों और/या संपादकों के नाम. (LITE प्रोजेक्शन में) | |
volumeInfo.publisher |
string |
इस वॉल्यूम का प्रकाशक. (LITE प्रोजेक्शन में.) | |
volumeInfo.publishedDate |
string |
पब्लिकेशन की तारीख. (LITE प्रोजेक्शन में.) | |
volumeInfo.description |
string |
वॉल्यूम की खास जानकारी. ब्यौरे का टेक्स्ट, एचटीएमएल में फ़ॉर्मैट किया जाता है. इसमें फ़ॉर्मैटिंग के आसान एलिमेंट शामिल होते हैं, जैसे कि b, i, और br टैग. (LITE प्रोजेक्शन में) | |
volumeInfo.industryIdentifiers[] |
list |
इस वॉल्यूम के लिए इंडस्ट्री स्टैंडर्ड आइडेंटिफ़ायर. | |
volumeInfo.industryIdentifiers[].type |
string |
आइडेंटिफ़ायर टाइप. इस एट्रिब्यूट की वैल्यू के तौर पर, ISBN_10, ISBN_13, ISSN, और OTHER का इस्तेमाल किया जा सकता है. | |
volumeInfo.industryIdentifiers[].identifier |
string |
उद्योग के लिए खास वॉल्यूम आइडेंटिफ़ायर. | |
volumeInfo.pageCount |
integer |
पेजों की कुल संख्या. | |
volumeInfo.dimensions |
object |
इस वॉल्यूम के फ़िज़िकल डाइमेंशन. | |
volumeInfo.dimensions.height |
string |
इस वॉल्यूम की ऊंचाई या लंबाई (सें॰मी॰ में). | |
volumeInfo.dimensions.width |
string |
इस वॉल्यूम की चौड़ाई (सेंटीमीटर में). | |
volumeInfo.dimensions.thickness |
string |
इस वॉल्यूम की मोटाई (सें॰मी॰). | |
volumeInfo.printType |
string |
इस वॉल्यूम के पब्लिकेशन का टाइप. संभावित वैल्यू, BOOK या MAGAZINE हैं. | |
volumeInfo.categories[] |
list |
विषय की कैटगरी की सूची, जैसे कि "फ़िक्शन", "सस्पेंस" वगैरह. | |
volumeInfo.averageRating |
double |
इस वॉल्यूम के लिए औसत समीक्षा रेटिंग. (कम से कम = 1.0, ज़्यादा से ज़्यादा = 5.0) | |
volumeInfo.ratingsCount |
integer |
इस वॉल्यूम के लिए समीक्षा रेटिंग की संख्या. | |
volumeInfo.contentVersion |
string |
वॉल्यूम के कॉन्टेंट (टेक्स्ट और इमेज) के वर्शन का आइडेंटिफ़ायर. (LITE प्रोजेक्शन में) | |
volumeInfo.imageLinks |
object |
उपलब्ध सभी साइज़ के लिए इमेज के लिंक की सूची. (LITE प्रोजेक्शन में) | |
volumeInfo.imageLinks.thumbnail |
string |
थंबनेल साइज़ (चौड़ाई ~128 पिक्सल) के लिए इमेज का लिंक. (LITE प्रोजेक्शन में) | |
volumeInfo.imageLinks.small |
string |
छोटे साइज़ (चौड़ाई ~300 पिक्सल) के लिए इमेज का लिंक. (LITE प्रोजेक्शन में) | |
volumeInfo.imageLinks.medium |
string |
मीडियम साइज़ (चौड़ाई ~575 पिक्सल) के लिए इमेज का लिंक. (LITE प्रोजेक्शन में) | |
volumeInfo.imageLinks.large |
string |
बड़े साइज़ (चौड़ाई ~800 पिक्सल) के लिए इमेज का लिंक. (LITE प्रोजेक्शन में) | |
volumeInfo.imageLinks.smallThumbnail |
string |
छोटे थंबनेल साइज़ (चौड़ाई ~80 पिक्सल) के लिए इमेज का लिंक. (LITE प्रोजेक्शन में) | |
volumeInfo.imageLinks.extraLarge |
string |
बहुत बड़े साइज़ (~1280 पिक्सल की चौड़ाई) के लिए इमेज का लिंक. (LITE प्रोजेक्शन में) | |
volumeInfo.language |
string |
कॉन्टेंट के हिसाब से, इस वॉल्यूम के लिए सबसे सही भाषा. यह दो अक्षरों वाला ISO 639-1 कोड होता है, जैसे कि 'fr', 'en' वगैरह. | |
volumeInfo.mainCategory |
string |
वह मुख्य कैटगरी जिससे यह वॉल्यूम जुड़ा है. यह नीचे दी गई कैटगरी की सूची में से वह कैटगरी होगी जिसका वेट सबसे ज़्यादा होगा. | |
volumeInfo.previewLink |
string |
Google Books की साइट पर इस वॉल्यूम की झलक देखने के लिए यूआरएल. | |
userInfo |
object |
इस वॉल्यूम से जुड़ी, उपयोगकर्ता से जुड़ी जानकारी. (उदाहरण के लिए, वह पेज जिसे उपयोगकर्ता ने आखिरी बार पढ़ा था या उसने यह किताब खरीदी है या नहीं) | |
userInfo.review |
nested object |
अगर इस उपयोगकर्ता ने इस वॉल्यूम की समीक्षा की है, तो उसकी समीक्षा. | |
userInfo.readingPosition |
readingPosition Resource |
अगर उपलब्ध हो, तो वॉल्यूम में उपयोगकर्ता की मौजूदा रीडिंग पोज़िशन. (LITE प्रोजेक्शन में.) | |
userInfo.isPurchased |
boolean |
अनुरोध करने वाले पुष्टि किए गए उपयोगकर्ता ने यह वॉल्यूम खरीदा है या नहीं. (LITE प्रोजेक्शन में.) | |
saleInfo |
object |
किसी वॉल्यूम के बारे में ऐसी जानकारी जो ई-बुक स्टोर और/या खरीदारी की सुविधा से जुड़ी हो. यह जानकारी उस देश पर निर्भर कर सकती है जहां से अनुरोध किया गया है (यानी कि कुछ देशों में किताबें बिक्री के लिए नहीं उपलब्ध हो सकती हैं). | |
saleInfo.country |
string |
दो अक्षरों वाला ISO_3166-1 देश कोड, जिसके लिए यह सेल की जानकारी मान्य है. (LITE प्रोजेक्शन में.) | |
saleInfo.saleability |
string |
यह किताब ऊपर बताए गए देशों में Google ई-बुकस्टोर में बिक्री के लिए उपलब्ध है या मुफ़्त में उपलब्ध है. इस एट्रिब्यूट की वैल्यू के तौर पर, FOR_SALE, FREE, NOT_FOR_SALE या FOR_PREORDER का इस्तेमाल किया जा सकता है. | |
saleInfo.isEbook |
boolean |
यह वॉल्यूम ई-बुक है या नहीं (इसे 'मेरी ई-बुक' शेल्फ़ में जोड़ा जा सकता है). | |
saleInfo.listPrice |
object |
सुझाई गई खुदरा कीमत. (LITE प्रोजेक्शन में) | |
saleInfo.listPrice.amount |
double |
नीचे दी गई मुद्रा में रकम. (LITE प्रोजेक्शन में.) | |
saleInfo.listPrice.currencyCode |
string |
ISO 4217, तीन अक्षर वाला मुद्रा कोड. (LITE प्रोजेक्शन में.) | |
saleInfo.retailPrice |
object |
किताब की असल कीमत. यह कीमत, सुझाई गई रीटेल या लिस्ट कीमत के बराबर होती है. हालांकि, अगर इस वॉल्यूम पर ऑफ़र या छूट दी जाती है, तो कीमत अलग हो सकती है. (LITE प्रोजेक्शन में) | |
saleInfo.retailPrice.amount |
double |
नीचे दी गई मुद्रा में रकम. (LITE प्रोजेक्शन में.) | |
saleInfo.retailPrice.currencyCode |
string |
ISO 4217 का तीन अक्षर वाला मुद्रा कोड. (LITE प्रोजेक्शन में.) | |
saleInfo.buyLink |
string |
Google Books की साइट पर इस वॉल्यूम को खरीदने के लिए यूआरएल. (LITE प्रोजेक्शन में) | |
accessInfo |
object |
किसी वॉल्यूम के टेक्स्ट को पढ़ने या उसे पाने से जुड़ी जानकारी. यह जानकारी देश के हिसाब से अलग-अलग हो सकती है. उदाहरण के लिए, हो सकता है कि किताबें किसी देश में पब्लिक डोमेन में हों, लेकिन किसी दूसरे देश में न हों. | |
accessInfo.country |
string |
दो अक्षर वाला ISO_3166-1 देश का कोड, जिसके लिए ऐक्सेस की यह जानकारी मान्य है. (LITE प्रोजेक्शन में.) | |
accessInfo.viewability |
string |
किसी वॉल्यूम को पढ़ने का ऐक्सेस. संभावित वैल्यू PARTIAL, ALL_PAGES, NO_PAGES या UNKNOWN हैं. यह वैल्यू ऊपर दिए गए देश के हिसाब से तय होती है. पार्शियल वैल्यू का मतलब है कि पब्लिशर ने वॉल्यूम के कुछ हिस्से को, बिना खरीदारी के सार्वजनिक तौर पर देखने की अनुमति दी है. यह शर्त, ई-बुक के साथ-साथ अन्य किताबों पर भी लागू हो सकती है. पब्लिक डोमेन की किताबों के लिए, इस फ़ील्ड की वैल्यू हमेशा ALL_PAGES होगी. | |
accessInfo.epub |
object |
epub कॉन्टेंट के बारे में जानकारी. (LITE प्रोजेक्शन में) | |
accessInfo.epub.downloadLink |
string |
epub डाउनलोड करने के लिए यूआरएल. (LITE प्रोजेक्शन में.) | |
accessInfo.epub.acsTokenLink |
string |
epub डाउनलोड के लिए ACS टोकन पाने का यूआरएल. (LITE प्रोजेक्शन में.) | |
accessInfo.pdf |
object |
PDF कॉन्टेंट के बारे में जानकारी. (LITE प्रोजेक्शन में) | |
accessInfo.pdf.downloadLink |
string |
PDF डाउनलोड करने के लिए यूआरएल. (LITE प्रोजेक्शन में.) | |
accessInfo.pdf.acsTokenLink |
string |
PDF डाउनलोड करने के लिए, एसीएस टोकन पाने का यूआरएल. (LITE प्रोजेक्शन में.) | |
accessInfo.accessViewStatus |
string |
इस उपयोगकर्ता के लिए, इस वॉल्यूम के ऐक्सेस और व्यू की सुविधा को एक ही स्टेटस फ़ील्ड में जोड़ता है. मान FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE या NONE हो सकते हैं. (LITE प्रोजेक्शन में.) | |
accessInfo.embeddable |
boolean |
क्या इस वॉल्यूम को एम्बेड किए गए व्यूअर एपीआई का इस्तेमाल करके, व्यूपोर्ट में एम्बेड किया जा सकता है. | |
accessInfo.publicDomain |
boolean |
ऊपर बताए गए देश में यह किताब सभी के लिए उपलब्ध है या नहीं. | |
|
string |
Google Books की साइट पर इस वॉल्यूम के बारे में जानकारी देखने के लिए यूआरएल. (LITE प्रोजेक्शन में) | |
userInfo.updated |
datetime |
वह टाइमस्टैंप जब उपयोगकर्ता की कार्रवाई ने इस वॉल्यूम में आखिरी बार बदलाव किया था. जैसे, पढ़ने की स्थिति का अपडेट, वॉल्यूम की खरीदारी या समीक्षा लिखना. (आरएफ़सी 3339 यूटीसी तारीख-समय फ़ॉर्मैट). | |
volumeInfo.canonicalVolumeLink |
string |
किसी वॉल्यूम का कैननिकल यूआरएल. (LITE प्रोजेक्शन में.) | |
userInfo.isPreordered |
boolean |
पुष्टि किए गए उपयोगकर्ता ने इस वॉल्यूम को पहले से ऑर्डर किया है या नहीं. (LITE प्रोजेक्शन में.) | |
saleInfo.onSaleDate |
datetime |
वह तारीख जब यह किताब बिक्री के लिए उपलब्ध होगी. | |
accessInfo.textToSpeechPermission |
string |
इस वॉल्यूम के लिए, लिखाई को बोली में बदलने की सुविधा उपलब्ध है या नहीं. वैल्यू के तौर पर ALLOWED, ALLOWED_FOR_ACCESSIBILITY या NOT_ALLOWED का इस्तेमाल किया जा सकता है. | |
accessInfo.epub.isAvailable |
boolean |
क्या फ़्लोइंग टेक्स्ट वाली epub फ़ाइल, सार्वजनिक तौर पर उपलब्ध है या खरीदने के लिए उपलब्ध है. (LITE प्रोजेक्शन में.) | |
accessInfo.pdf.isAvailable |
boolean |
क्या स्कैन की गई इमेज का PDF, सार्वजनिक तौर पर उपलब्ध है या खरीदने के लिए उपलब्ध है. (LITE प्रोजेक्शन में.) | |
accessInfo.webReaderLink |
string |
Google Books की साइट पर इस वॉल्यूम को पढ़ने के लिए यूआरएल. लिंक की मदद से, उपयोगकर्ता वे वॉल्यूम नहीं पढ़ पाएंगे जिन्हें नहीं देखा जा सकता. | |
accessInfo.downloadAccess |
nested object |
किसी वॉल्यूम के डाउनलोड किए गए लाइसेंस के ऐक्सेस से जुड़ी पाबंदियों के बारे में जानकारी. | |
accessInfo.downloadAccess.kind |
string |
संसाधन का टाइप. | |
accessInfo.downloadAccess.volumeId |
string |
उस वॉल्यूम की पहचान करता है जिसके लिए यह एंट्री लागू होती है. | |
accessInfo.downloadAccess.restricted |
boolean |
इस वॉल्यूम को डाउनलोड करने पर पाबंदी है या नहीं. | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
अगर पाबंदी लगी है, तो यह पता चलता है कि इस (उपयोगकर्ता, डिवाइस, वॉल्यूम) के लिए ऐक्सेस दिया गया है या नहीं. | |
accessInfo.downloadAccess.justAcquired |
boolean |
अगर deviceAllowed है, तो यह पता चलता है कि क्या इस अनुरोध के साथ ही ऐक्सेस हासिल किया गया था. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
अगर पाबंदी लगी है, तो इस वॉल्यूम के लिए कॉन्टेंट डाउनलोड करने के लाइसेंस की ज़्यादा से ज़्यादा संख्या. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
अगर पाबंदी लगी है, तो कॉन्टेंट डाउनलोड करने के लिए पहले से लिए गए लाइसेंस की संख्या. इसमें, अनुरोध करने वाले क्लाइंट का लाइसेंस भी शामिल है. | |
accessInfo.downloadAccess.nonce |
string |
पुष्टि करने के लिए क्लाइंट नॉन्स. सिर्फ़ क्लाइंट की पुष्टि और डाउनलोड करने का ऐक्सेस. | |
accessInfo.downloadAccess.source |
string |
पुष्टि करने के लिए क्लाइंट ऐप्लिकेशन आइडेंटिफ़ायर. सिर्फ़ क्लाइंट की पुष्टि और डाउनलोड करने का ऐक्सेस. | |
accessInfo.downloadAccess.reasonCode |
string |
गड़बड़ी/चेतावनी की वजह बताने वाला कोड. आने वाले समय में, अन्य कोड जोड़े जा सकते हैं. 0 ठीक है 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS | |
accessInfo.downloadAccess.message |
string |
गड़बड़ी/चेतावनी का मैसेज. | |
accessInfo.downloadAccess.signature |
string |
जवाब का हस्ताक्षर. | |
searchInfo |
object |
इस वॉल्यूम से जुड़े खोज के नतीजों की जानकारी. | |
searchInfo.textSnippet |
string |
खोज क्वेरी वाला टेक्स्ट स्निपेट. |