مجموعه
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 | اطلاعاتی در مورد محتوای پی دی اف. (در طرح 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 | اینکه آیا این کتاب در کشور فهرست شده در بالا مالکیت عمومی است یا خیر. | |
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 | یک قطعه متن حاوی عبارت جستجو. |