مستوى الصوت

تُستخدَم مجموعة Volume لإجراء بحث أو عرض محتوى رفّ كتب. هذه المجموعة للقراءة فقط.

الطُرق

تنطبق الطرق التالية على البيانات العامة حول أحجام التخزين ولا تتطلّب مصادقة.
books.volumes.list
books.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 معرّف غير شفاف لإصدار معيّن من مورد وحدة تخزين (في العرض المميّز)
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.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 الفئة الرئيسية التي ينتمي إليها هذا المجلد. ستكون الفئة من قائمة الفئات المعروضة أدناه هي الفئة التي لها أعلى وزن.
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)
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.pdf object معلومات عن محتوى ملف pdf (في الإسقاط البسيط)
accessInfo.accessViewStatus string تجمع هذه السمة بين إمكانية الوصول إلى هذا المجلد وإمكانية عرضه في حقل حالة واحد لهذا المستخدم. يمكن أن تكون القيم FULL_PURCHASED أو FULL_PUBLIC_DOMAIN أو SAMPLE أو NONE. (في العرض المميّز بتنسيق LITE)
accessInfo.embeddable boolean ما إذا كان يمكن تضمين هذا المجلد في مساحة عرض باستخدام واجهة برمجة التطبيقات Embedded Viewer API
accessInfo.publicDomain boolean ما إذا كان هذا الكتاب متاحًا في نطاق عام في البلد المدرَج أعلاه أم لا
userInfo.updated datetime الطابع الزمني لآخر تعديل على هذا المجلد من خلال إجراء من قِبل المستخدم، مثل تعديل موضع القراءة أو شراء المجلد أو كتابة مراجعة (تنسيق التاريخ والوقت بالتوقيت العالمي المنسق وفقًا لمعيار RFC 3339)
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 حسنًا 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 مقتطف نصي يحتوي على طلب البحث