वॉल्यूम

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

तरीके

नीचे दिए गए तरीके, वॉल्यूम के सार्वजनिक डेटा पर लागू होते हैं. इसके लिए पुष्टि करने की ज़रूरत नहीं है.
books.volumes.list
books.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 प्रोजेक्शन में)
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.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 या 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 प्रोजेक्शन में.)
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.pdf object pdf कॉन्टेंट के बारे में जानकारी. (LITE प्रोजेक्शन में)
accessInfo.accessViewStatus string यह इस उपयोगकर्ता के लिए इस वॉल्यूम के ऐक्सेस और विज्ञापन दिखने से जुड़े आंकड़े को सिंगल स्टेटस फ़ील्ड में जोड़ता है. मान FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE या NONE हो सकते हैं. (LITE प्रोजेक्शन में.)
accessInfo.embeddable boolean इस वॉल्यूम को एम्बेड किए गए व्यूअर API का इस्तेमाल करके व्यूपोर्ट में एम्बेड किया जा सकता है या नहीं.
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 खोज क्वेरी वाला टेक्स्ट स्निपेट.