वॉल्यूम

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, 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 अगर 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 खोज क्वेरी वाला टेक्स्ट स्निपेट.