تُستخدَم مجموعة
Volume
لإجراء بحث أو عرض محتوى رفّ كتب. هذه المجموعة للقراءة فقط.الطُرق
تنطبق الطرق التالية على البيانات العامة حول أحجام التخزين ولا تتطلّب مصادقة.
books.volumes.listbooks.volumes.get
تنطبق الطريقة التالية على طريقة العرض الخاصة "مكتبتي" للمجلدات وتتطلّب المصادقة.
books.mylibrary.bookshelves.volumes.list- الحصول
- استرداد مورد مجلّد استنادًا إلى المعرّف
- list
- يُجري عملية بحث عن كتاب.
تمثيلات الموارد
يمثّل المجلد المعلومات التي تستضيفها "كتب Google" عن كتاب أو مجلة. ويحتوي على بيانات وصفية، مثل العنوان والمؤلف، بالإضافة إلى بيانات مخصّصة، مثل ما إذا تم شراء الكتاب أم لا. (يُرجى الاطّلاع أدناه على حقول الحجم المتاحة في الإسقاط البسيط).
{ "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 |
معرّف غير شفاف لإصدار معيّن من مورد وحدة تخزين (في العرض المميّز) | |
selfLink |
string |
عنوان URL لهذا المرجع (في العرض المميّز بتنسيق LITE) | |
volumeInfo |
object |
معلومات عامة عن حجم المحتوى | |
volumeInfo.title |
string |
عنوان المجلد (في العرض المميّز بتنسيق LITE) | |
volumeInfo.subtitle |
string |
العنوان الفرعي للحجم (في العرض المميّز بتنسيق LITE) | |
volumeInfo.authors[] |
list |
أسماء المؤلفين و/أو المحررين لهذا المجلد (في العرض المميّز بدقة منخفضة) | |
volumeInfo.publisher |
string |
ناشر هذا المجلد. (في العرض المميّز بتنسيق LITE) | |
volumeInfo.publishedDate |
string |
تاريخ النشر (في العرض المميّز بتنسيق LITE) | |
volumeInfo.description |
string |
ملخّص للعدد يتم تنسيق نص الوصف بتنسيق HTML ويتضمن عناصر تنسيق بسيطة، مثل علامات b وi وbr. (في الإسقاط البسيط) | |
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 |
معرّف لإصدار محتوى المجلد (النص والصور) (في العرض المميّز) | |
volumeInfo.imageLinks |
object |
قائمة بروابط الصور لجميع الأحجام المتاحة (في الإسقاط البسيط) | |
volumeInfo.imageLinks.thumbnail |
string |
رابط الصورة لحجم الصورة المصغّرة (عرض 128 بكسل تقريبًا) (في الإسقاط البسيط) | |
volumeInfo.imageLinks.small |
string |
رابط الصورة لحجم صغير (عرض 300 بكسل تقريبًا) (في الإسقاط البسيط) | |
volumeInfo.imageLinks.medium |
string |
رابط الصورة بحجم متوسط (عرض 575 بكسل تقريبًا) (في الإسقاط البسيط) | |
volumeInfo.imageLinks.large |
string |
رابط الصورة بالحجم الكبير (عرض 800 بكسل تقريبًا) (في الإسقاط البسيط) | |
volumeInfo.imageLinks.smallThumbnail |
string |
رابط الصورة لحجم الصورة المصغّرة الصغيرة (عرضها 80 بكسل تقريبًا) (في الإسقاط البسيط) | |
volumeInfo.imageLinks.extraLarge |
string |
رابط الصورة لحجم كبير جدًا (عرض 1280 بكسل تقريبًا) (في الإسقاط البسيط) | |
volumeInfo.language |
string |
أفضل لغة لهذا المجلد (استنادًا إلى المحتوى) وهو الرمز المكوّن من حرفَين وفقًا لمعيار ISO 639-1، مثل "fr" و"en" وما إلى ذلك. | |
volumeInfo.mainCategory |
string |
الفئة الرئيسية التي ينتمي إليها هذا المجلد. ستكون الفئة من قائمة الفئات المعروضة أدناه هي الفئة التي لها أعلى وزن. | |
volumeInfo.previewLink |
string |
عنوان URL لمعاينة هذا المجلد على موقع "كتب Google" الإلكتروني | |
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 |
السعر المُقترَح للبيع بالتجزئة (في الإسقاط البسيط) | |
saleInfo.listPrice.amount |
double |
المبلغ بالعملة المدرَجة أدناه (في العرض المميّز بتنسيق LITE) | |
saleInfo.listPrice.currencyCode |
string |
رمز عملة مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217 (في العرض المميّز بتنسيق LITE) | |
saleInfo.retailPrice |
object |
السعر الفعلي لبيع الكتاب. هذا السعر هو نفسه السعر المقترَح للبيع بالتجزئة أو السعر المحدَّد في القائمة، ما لم تكن هناك عروض أو خصومات على هذا العدد. (في الإسقاط البسيط) | |
saleInfo.retailPrice.amount |
double |
المبلغ بالعملة المدرَجة أدناه (في العرض المميّز بتنسيق LITE) | |
saleInfo.retailPrice.currencyCode |
string |
رمز عملة مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217 (في العرض المميّز بتنسيق LITE) | |
saleInfo.buyLink |
string |
عنوان URL لشراء هذا المجلد على موقع "كتب Google" الإلكتروني (في الإسقاط البسيط) | |
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 (في الإسقاط البسيط) | |
accessInfo.epub.downloadLink |
string |
عنوان URL لتنزيل ملف epub (في العرض المميّز بتنسيق LITE) | |
accessInfo.epub.acsTokenLink |
string |
عنوان URL لاسترداد الرمز المميّز لخدمة ACS لتنزيل ملف epub (في العرض المميّز بتنسيق LITE) | |
accessInfo.pdf |
object |
معلومات عن محتوى ملف pdf (في الإسقاط البسيط) | |
accessInfo.pdf.downloadLink |
string |
عنوان URL لتنزيل ملف 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 | |
accessInfo.publicDomain |
boolean |
ما إذا كان هذا الكتاب متاحًا في نطاق عام في البلد المدرَج أعلاه أم لا | |
|
string |
عنوان URL لعرض معلومات عن هذا المجلد على موقع "كتب Google" الإلكتروني (في العرض المميّز) | |
userInfo.updated |
datetime |
الطابع الزمني لآخر تعديل على هذا المجلد من خلال إجراء من قِبل المستخدم، مثل تعديل موضع القراءة أو شراء المجلد أو كتابة مراجعة (تنسيق التاريخ والوقت بالتوقيت العالمي المنسق وفقًا لمعيار RFC 3339) | |
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" الإلكتروني لن يسمح الرابط للمستخدمين بقراءة المجلدات غير القابلة للعرض. | |
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 |
مقتطف نصي يحتوي على طلب البحث |