वॉल्यूम

Volume कलेक्शन का इस्तेमाल, किताबों की अलमारी का कॉन्टेंट खोजने या उसकी लिस्टिंग करने के लिए किया जाता है. इस कलेक्शन को सिर्फ़ पढ़ा जा सकता है.

तरीके

नीचे दिए गए तरीके, वॉल्यूम के बारे में सार्वजनिक डेटा पर लागू होते हैं और इनके लिए पुष्टि करने की ज़रूरत नहीं होती.
books.volumes.list
books.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 प्रोजेक्शन में)
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.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 यह वॉल्यूम से जुड़ी मुख्य कैटगरी. यहां दी गई कैटगरी की सूची में से, सबसे ज़्यादा प्राथमिकता वाली कैटगरी होगी.
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 प्रोजेक्शन में.)
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.pdf object PDF कॉन्टेंट के बारे में जानकारी. (LITE प्रोजेक्शन में)
accessInfo.accessViewStatus string इस वॉल्यूम के ऐक्सेस और विज्ञापन दिखने से जुड़े आंकड़ों को इस उपयोगकर्ता के लिए एक स्टेटस फ़ील्ड में जोड़ता है. मान FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE या NONE हो सकते हैं. (LITE प्रोजेक्शन में.)
accessInfo.embeddable boolean क्या इस वॉल्यूम को एम्बेड किए गए व्यूअर एपीआई का इस्तेमाल करके, व्यूपोर्ट में एम्बेड किया जा सकता है.
accessInfo.publicDomain boolean ऊपर दिए गए देश में, यह किताब सभी के लिए उपलब्ध है या नहीं.
userInfo.updated datetime वह टाइमस्टैंप जब उपयोगकर्ता की कार्रवाई ने इस वॉल्यूम में आखिरी बार बदलाव किया था. जैसे, पढ़ने की स्थिति का अपडेट, वॉल्यूम की खरीदारी या समीक्षा लिखना. (आरएफ़सी 3339 यूटीसी तारीख-समय फ़ॉर्मैट).
userInfo.isPreordered boolean अनुरोध करने वाले प्रमाणित उपयोगकर्ता ने इस वॉल्यूम के लिए पहले से ऑर्डर किया था या नहीं. (LITE प्रोजेक्शन में.)
saleInfo.onSaleDate datetime वह तारीख जब यह किताब बिक्री के लिए उपलब्ध होगी.
accessInfo.textToSpeechPermission string इस वॉल्यूम के लिए लिखाई को बोली में बदलने की अनुमति है या नहीं. मान की अनुमति नहीं है, ALLOWED_FOR_ACCESSIBILITY या NOT_ALLOWED.
accessInfo.epub.isAvailable boolean फ़्लोइंग टेक्स्ट epub फ़ॉर्मैट, सार्वजनिक डोमेन के तौर पर या खरीदारी के लिए उपलब्ध हो. (LITE प्रोजेक्शन में.)
accessInfo.pdf.isAvailable boolean स्कैन की गई एक इमेज की PDF फ़ाइल हो, जो सभी के लिए उपलब्ध हो या खरीदने के लिए उपलब्ध हो. (LITE प्रोजेक्शन में.)
accessInfo.downloadAccess nested object किसी वॉल्यूम के डाउनलोड लाइसेंस के ऐक्सेस से जुड़ी पाबंदियों के बारे में जानकारी.
accessInfo.downloadAccess.kind string संसाधन प्रकार.
accessInfo.downloadAccess.volumeId string उस वॉल्यूम की पहचान करता है जिसके लिए यह एंट्री लागू होती है.
accessInfo.downloadAccess.restricted boolean इस वॉल्यूम में डाउनलोड ऐक्सेस करने पर कोई पाबंदी है या नहीं.
accessInfo.downloadAccess.deviceAllowed boolean अगर पाबंदी लगी है, तो यह ऐक्सेस दिया जाएगा या नहीं (उपयोगकर्ता, डिवाइस, वॉल्यूम).
accessInfo.downloadAccess.justAcquired boolean अगर deviceअनुमति दी गई है, तो यह देखें कि क्या ऐक्सेस अभी-अभी इस अनुरोध के साथ हासिल किया गया था.
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_USE_LAST_ACCESS
accessInfo.downloadAccess.message string गड़बड़ी/चेतावनी संदेश.
accessInfo.downloadAccess.signature string जवाब के हस्ताक्षर.
searchInfo object इस वॉल्यूम से जुड़े खोज नतीजे की जानकारी.
searchInfo.textSnippet string खोज क्वेरी वाला टेक्स्ट स्निपेट.