جلد

مجموعه Volume برای انجام جستجو یا فهرست کردن محتویات یک قفسه کتاب استفاده می شود. این مجموعه یک مجموعه فقط خواندنی است.

روش ها

روش های زیر برای داده های عمومی در مورد حجم ها اعمال می شود و نیازی به احراز هویت ندارند.
کتاب.جلد.فهرست
کتابها.جلدها.به دست آوردن

روش زیر برای نمای خصوصی، «کتابخانه من» مجلدات اعمال می‌شود و نیاز به احراز هویت دارد.
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 نوع منبع برای یک جلد (در طرح 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 خلاصه ای از جلد. متن توضیحات در HTML قالب بندی شده است و شامل عناصر قالب بندی ساده مانند تگ های 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 یا ناشناخته هستند. این مقدار به کشور ذکر شده در بالا بستگی دارد. مقدار PARTIAL به این معنی است که ناشر اجازه داده است که بخشی از جلد به صورت عمومی و بدون خرید مشاهده شود. این می تواند برای کتاب های الکترونیکی و همچنین کتاب های غیر الکترونیکی اعمال شود. ارزش کتاب های دامنه عمومی همیشه ALL_PAGES خواهد بود.
accessInfo. epub object اطلاعاتی در مورد محتوای epub. (در طرح LITE)
accessInfo. pdf object اطلاعاتی در مورد محتوای پی دی اف. (در طرح LITE)
accessInfo. accessViewStatus string دسترسی و قابلیت مشاهده این حجم را در یک فیلد وضعیت واحد برای این کاربر ترکیب می کند. مقادیر می توانند FULL_PURCHASED، FULL_PUBLIC_DOMAIN، SAMPLE یا NONE باشند. (در طرح LITE.)
accessInfo. embeddable boolean آیا می توان این حجم را با استفاده از Embedded Viewer API در یک viewport جاسازی کرد یا خیر.
accessInfo. publicDomain boolean اینکه آیا این کتاب در کشور فهرست شده در بالا مالکیت عمومی است یا خیر.
userInfo. updated datetime آخرین باری که این جلد توسط یک اقدام کاربر، مانند به‌روزرسانی موقعیت خواندن، خرید حجم یا نوشتن نظر، آخرین بار اصلاح شده است، مهر زمانی. (فرمت RFC 3339 UTC تاریخ-زمان).
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 OK 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 یک قطعه متن حاوی عبارت جستجو.