আয়তন

একটি Volume সংগ্রহ একটি অনুসন্ধান বা একটি বুকশেলফের বিষয়বস্তু তালিকাভুক্ত করতে ব্যবহৃত হয়। এই সংগ্রহটি শুধুমাত্র পঠনযোগ্য সংগ্রহ।

পদ্ধতি

নিম্নলিখিত পদ্ধতিগুলি ভলিউম সম্পর্কে পাবলিক ডেটাতে প্রযোজ্য এবং প্রমাণীকরণের প্রয়োজন নেই৷
book.volumes.list
book.volumes.get

নিম্নলিখিত পদ্ধতিটি ভলিউমের ব্যক্তিগত, "আমার লাইব্রেরি" ভিউতে প্রযোজ্য এবং প্রমাণীকরণের প্রয়োজন।
books.mylibrary.bookshelves.volumes.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 একটি ভলিউমের জন্য সম্পদের ধরন। (লাইট প্রজেকশনে।)
id string একটি ভলিউমের জন্য অনন্য শনাক্তকারী। (লাইট প্রজেকশনে।)
etag string ভলিউম রিসোর্সের একটি নির্দিষ্ট সংস্করণের জন্য অস্বচ্ছ শনাক্তকারী। (লাইট প্রজেকশনে)
volumeInfo object সাধারণ ভলিউম তথ্য।
volumeInfo. title string ভলিউম শিরোনাম। (লাইট প্রজেকশনে।)
volumeInfo. subtitle string ভলিউম সাবটাইটেল। (লাইট প্রজেকশনে।)
volumeInfo. authors[] list এই ভলিউমের লেখক এবং/অথবা সম্পাদকদের নাম। (লাইট প্রজেকশনে)
volumeInfo. publisher string এই খণ্ডের প্রকাশক। (লাইট প্রজেকশনে।)
volumeInfo. publishedDate string প্রকাশের তারিখ। (লাইট প্রজেকশনে।)
volumeInfo. description string আয়তনের একটি সংক্ষিপ্তসার। বর্ণনার পাঠ্যটি HTML-এ বিন্যাসিত হয় এবং এতে সহজ বিন্যাস উপাদান, যেমন 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 এই ভলিউম প্রকাশনার ধরন. সম্ভাব্য মান হল বুক বা ম্যাগাজিন।
volumeInfo. categories[] list বিষয়শ্রেণীর একটি তালিকা, যেমন "ফিকশন", "সাসপেন্স" ইত্যাদি।
volumeInfo. averageRating double এই ভলিউমের জন্য গড় পর্যালোচনা রেটিং। (মিনিট = 1.0, সর্বোচ্চ = 5.0)
volumeInfo. ratingsCount integer এই ভলিউমের জন্য পর্যালোচনা রেটিং সংখ্যা.
volumeInfo. contentVersion string ভলিউম বিষয়বস্তুর সংস্করণের জন্য একটি শনাক্তকারী (পাঠ্য এবং ছবি)। (লাইট প্রজেকশনে)
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 ভলিউমে ব্যবহারকারীর বর্তমান পড়ার অবস্থান, যদি একটি উপলব্ধ থাকে। (লাইট প্রজেকশনে।)
userInfo. isPurchased boolean এই ভলিউমটি যাচাইকৃত ব্যবহারকারীর দ্বারা ক্রয় করা হয়েছে কিনা তা অনুরোধ করা হয়েছে। (লাইট প্রজেকশনে।)
saleInfo object ই-বুকস্টোর এবং/অথবা ক্রয়যোগ্যতার সাথে সম্পর্কিত একটি ভলিউম সম্পর্কে যেকোনো তথ্য। এই তথ্যটি নির্ভর করতে পারে যে দেশ থেকে অনুরোধটি এসেছে (যেমন বইগুলি নির্দিষ্ট কিছু দেশে বিক্রির জন্য নাও হতে পারে)।
saleInfo. country string দুই-অক্ষরের ISO_3166-1 দেশের কোড যার জন্য এই বিক্রয় তথ্য বৈধ। (লাইট প্রজেকশনে।)
saleInfo. saleability string উপরে তালিকাভুক্ত দেশের জন্য এই বইটি Google eBookstore-এ বিক্রয়ের জন্য পাওয়া যায় বা বিনামূল্যে দেওয়া হয় কিনা। সম্ভাব্য মানগুলি হল FOR_SALE, বিনামূল্যে, NOT_FOR_SALE, বা FOR_PREORDER৷
saleInfo. isEbook boolean এই ভলিউমটি একটি ইবুক কিনা (আমার ইবুক শেল্ফে যোগ করা যেতে পারে)।
saleInfo. listPrice object প্রস্তাবিত খুচরা মূল্য. (LITE প্রজেকশনে)
saleInfo.listPrice. amount double নীচে তালিকাভুক্ত মুদ্রার পরিমাণ। (লাইট প্রজেকশনে।)
saleInfo.listPrice. currencyCode string একটি ISO 4217, তিন-অক্ষরের মুদ্রা কোড। (লাইট প্রজেকশনে।)
saleInfo. retailPrice object বইটির প্রকৃত বিক্রয় মূল্য। এই ভলিউমে অফার বা ছাড় না থাকলে এটি প্রস্তাবিত খুচরা বা তালিকা মূল্যের মতোই। (LITE প্রজেকশনে)
saleInfo.retailPrice. amount double নীচে তালিকাভুক্ত মুদ্রার পরিমাণ। (লাইট প্রজেকশনে।)
saleInfo.retailPrice. currencyCode string একটি ISO 4217, তিন-অক্ষরের মুদ্রা কোড। (লাইট প্রজেকশনে।)
accessInfo object সেই ভলিউম টেক্সট পড়া বা প্রাপ্তির সাথে সম্পর্কিত একটি ভলিউম সম্পর্কে যেকোন তথ্য। এই তথ্য দেশের উপর নির্ভর করতে পারে (বইগুলি এক দেশে সর্বজনীন ডোমেইন হতে পারে কিন্তু অন্য দেশে নয়, যেমন)।
accessInfo. country string দুই-অক্ষরের ISO_3166-1 দেশের কোড যার জন্য এই অ্যাক্সেস তথ্য বৈধ। (লাইট প্রজেকশনে।)
accessInfo. viewability string একটি ভলিউমের পঠন অ্যাক্সেস। সম্ভাব্য মানগুলি হল আংশিক, ALL_PAGES, NO_PAGES বা UNKNOWN৷ এই মান উপরে তালিকাভুক্ত দেশের উপর নির্ভর করে। আংশিক মান মানে হল প্রকাশক ভলিউমের কিছু অংশ ক্রয় ছাড়াই সর্বজনীনভাবে দেখার অনুমতি দিয়েছেন। এটি ই-বুকগুলির পাশাপাশি নন-ইবুকের ক্ষেত্রেও প্রযোজ্য হতে পারে। পাবলিক ডোমেইন বইগুলির সর্বদা ALL_PAGES এর মান থাকবে৷
accessInfo. epub object epub বিষয়বস্তু সম্পর্কে তথ্য. (LITE প্রজেকশনে)
accessInfo. pdf object পিডিএফ বিষয়বস্তু সম্পর্কে তথ্য। (LITE প্রজেকশনে)
accessInfo. accessViewStatus string এই ব্যবহারকারীর জন্য একটি একক স্থিতি ক্ষেত্রে এই ভলিউমের অ্যাক্সেস এবং দর্শনযোগ্যতাকে একত্রিত করে৷ মান FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE বা NONE হতে পারে৷ (লাইট প্রজেকশনে।)
accessInfo. embeddable boolean এমবেডেড ভিউয়ার এপিআই ব্যবহার করে এই ভলিউমটি ভিউপোর্টে এম্বেড করা যাবে কিনা।
accessInfo. publicDomain boolean এই বইটি উপরে তালিকাভুক্ত দেশে পাবলিক ডোমেইন কিনা।
userInfo. updated datetime টাইমস্ট্যাম্প যখন এই ভলিউমটি একটি ব্যবহারকারীর ক্রিয়া দ্বারা সর্বশেষ পরিবর্তন করা হয়েছিল, যেমন একটি পড়ার অবস্থান আপডেট, ভলিউম ক্রয় বা একটি পর্যালোচনা লেখা৷ (RFC 3339 UTC তারিখ-সময় বিন্যাস)।
userInfo. isPreordered boolean এই ভলিউমটি প্রাক-অর্ডার করা হয়েছে কিনা প্রমাণীকৃত ব্যবহারকারী অনুরোধ করছেন। (লাইট প্রজেকশনে।)
saleInfo. onSaleDate datetime যে তারিখে এই বইটি বিক্রয়ের জন্য উপলব্ধ।
accessInfo. textToSpeechPermission string এই ভলিউমের জন্য টেক্সট-টু-স্পীচ অনুমোদিত কিনা। মানগুলি ALLOWED, ALLOWED_FOR_ACCESSIBILITY, বা NOT_ALLOWED হতে পারে৷
accessInfo.epub. isAvailable boolean একটি প্রবাহিত পাঠ্য epub হয় পাবলিক ডোমেন হিসাবে বা কেনার জন্য উপলব্ধ৷ (লাইট প্রজেকশনে।)
accessInfo.pdf. isAvailable boolean একটি স্ক্যান করা ছবি pdf হয় পাবলিক ডোমেন হিসাবে বা কেনার জন্য উপলব্ধ। (লাইট প্রজেকশনে।)
accessInfo. downloadAccess nested object একটি ভলিউমের ডাউনলোড লাইসেন্স অ্যাক্সেস সীমাবদ্ধতা সম্পর্কে তথ্য।
accessInfo.downloadAccess. kind string সম্পদের ধরন।
accessInfo.downloadAccess. volumeId string ভলিউম সনাক্ত করে যার জন্য এই এন্ট্রি প্রযোজ্য।
accessInfo.downloadAccess. restricted boolean এই ভলিউমের কোনো ডাউনলোড অ্যাক্সেস সীমাবদ্ধতা আছে কিনা।
accessInfo.downloadAccess. deviceAllowed boolean সীমাবদ্ধ থাকলে, এটির জন্য অ্যাক্সেস দেওয়া হয়েছে কিনা (ব্যবহারকারী, ডিভাইস, ভলিউম)।
accessInfo.downloadAccess. justAcquired boolean ডিভাইসের অনুমতি দেওয়া হলে, এই অনুরোধের মাধ্যমেই অ্যাক্সেস অর্জিত হয়েছে কিনা।
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 অনুসন্ধান ক্যোয়ারী ধারণকারী একটি পাঠ্য স্নিপেট।