Volume
संग्रह का इस्तेमाल किताबों की सूची को खोजने या उसकी सूची बनाने के लिए किया जाता है. यह कलेक्शन सिर्फ़ पढ़ने के लिए है.तरीके
नीचे दिए गए तरीके, वॉल्यूम के सार्वजनिक डेटा पर लागू होते हैं. इसके लिए पुष्टि करने की ज़रूरत नहीं है.
books.volumes.listbooks.volumes.get
नीचे दिया गया तरीका, वॉल्यूम के निजी "मेरी लाइब्रेरी" व्यू पर लागू होता है. साथ ही, पुष्टि करना ज़रूरी है.
books.mylibrary.bookshels.volumes.list- get
- आईडी के आधार पर आवाज़ को बढ़ाने वाला संसाधन फिर से हासिल करता है.
- 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, और अन्य हैं. | |
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 या OR_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 हैं. यह वैल्यू ऊपर दिए गए देश के हिसाब से तय होती है. PARTIAL के मान का मतलब है कि प्रकाशक ने खरीदारी के बिना, वॉल्यूम के कुछ हिस्से को सार्वजनिक तौर पर देखने की अनुमति दी है. यह ई-बुक के साथ-साथ बिना ई-बुक पर भी लागू हो सकता है. सार्वजनिक डोमेन वाली किताबों का मान हमेशा 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 |
पीडीएफ़ डाउनलोड करने के लिए यूआरएल. (LITE प्रोजेक्शन में.) | |
accessInfo.pdf.acsTokenLink |
string |
पीडीएफ़ डाउनलोड के लिए ACS टोकन फिर से पाने के लिए यूआरएल. (LITE प्रोजेक्शन में.) | |
accessInfo.accessViewStatus |
string |
यह इस उपयोगकर्ता के लिए इस वॉल्यूम के ऐक्सेस और विज्ञापन दिखने से जुड़े आंकड़े को सिंगल स्टेटस फ़ील्ड में जोड़ता है. मान FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE या NONE हो सकते हैं. (LITE प्रोजेक्शन में.) | |
accessInfo.embeddable |
boolean |
इस वॉल्यूम को एम्बेड किए गए व्यूअर API का इस्तेमाल करके व्यूपोर्ट में एम्बेड किया जा सकता है या नहीं. | |
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 |
खोज क्वेरी वाला टेक्स्ट स्निपेट. |