جلد

مجموعه 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)
selfLink	string	URL به این منبع. (در طرح 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	object	لیستی از پیوندهای تصویر برای همه اندازه‌های موجود. (در طرح 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	دسته اصلی که این جلد به آن تعلق دارد. این دسته از فهرست دسته بندی های بازگشتی در زیر خواهد بود که دارای بالاترین وزن است.
volumeInfo. previewLink	string	URL برای پیش نمایش این جلد در سایت Google Books.
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.)
saleInfo. buyLink	string	آدرس اینترنتی خرید این جلد در سایت Google Books. (در طرح 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.epub. downloadLink	string	URL برای دانلود epub. (در طرح LITE.)
accessInfo.epub. acsTokenLink	string	URL برای بازیابی رمز ACS برای دانلود epub. (در طرح LITE.)
accessInfo. pdf	object	اطلاعاتی در مورد محتوای pdf. (در طرح LITE)
accessInfo.pdf. downloadLink	string	آدرس برای دانلود pdf. (در طرح LITE.)
accessInfo.pdf. acsTokenLink	string	URL برای بازیابی رمز ACS برای دانلود pdf. (در طرح LITE.)
accessInfo. accessViewStatus	string	دسترسی و قابلیت مشاهده این حجم را در یک فیلد وضعیت واحد برای این کاربر ترکیب می کند. مقادیر می توانند FULL_PURCHASED، FULL_PUBLIC_DOMAIN، SAMPLE یا NONE باشند. (در طرح LITE.)
accessInfo. embeddable	boolean	آیا می توان این حجم را با استفاده از Embedded Viewer API در یک viewport جاسازی کرد یا خیر.
accessInfo. publicDomain	boolean	اینکه آیا این کتاب در کشور فهرست شده در بالا مالکیت عمومی است یا خیر.
volumeInfo. infoLink	string	URL برای مشاهده اطلاعات مربوط به این جلد در سایت Google Books. (در طرح LITE)
userInfo. updated	datetime	آخرین باری که این جلد توسط یک اقدام کاربر، مانند به‌روزرسانی موقعیت خواندن، خرید حجم یا نوشتن نظر، آخرین بار اصلاح شده است، مهر زمانی. (فرمت RFC 3339 UTC تاریخ-زمان).
volumeInfo. canonicalVolumeLink	string	URL متعارف برای یک جلد. (در طرح LITE.)
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. webReaderLink	string	URL برای خواندن این جلد در سایت Google Books. پیوند به کاربران اجازه نمی دهد حجم های غیرقابل مشاهده را بخوانند.
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	یک قطعه متن حاوی عبارت جستجو.