आवाज़

Volume संग्रह का इस्तेमाल, किताबों की अलमारी में मौजूद कॉन्टेंट को खोजने या उनकी सूची बनाने के लिए किया जाता है. यह संग्रह, रीड-ओनली मोड में है.

तरीके

यहां दिए गए तरीके, वॉल्यूम के सार्वजनिक डेटा पर लागू होते हैं. साथ ही, इनके लिए पुष्टि करने की ज़रूरत नहीं होती.
books.volumes.list
books.volumes.get

यह तरीका, वॉल्यूम के निजी "मेरी लाइब्रेरी" व्यू पर लागू होता है. इसके लिए, पुष्टि करना ज़रूरी है.
books.mylibrary.bookshelves.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 प्रोजेक्शन में)
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 eBookstore में इसे मुफ़्त में ऑफ़र किया गया है या नहीं. संभावित वैल्यू: 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 खोज क्वेरी वाला टेक्स्ट स्निपेट.