مستوى الصوت

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

الطُرق

تنطبق الطرق التالية على البيانات العامة حول أحجام التخزين ولا تتطلّب مصادقة.
books.volumes.list
books.volumes.get

تنطبق الطريقة التالية على طريقة العرض الخاصة "مكتبتي" للمجلدات وتتطلّب المصادقة.
books.mylibrary.bookshelves.volumes.list

الحصول
استرداد مورد مجلّد استنادًا إلى المعرّف
list
يُجري عملية بحث عن كتاب.

تمثيلات الموارد

يمثّل المجلد المعلومات التي تستضيفها "كتب Google" عن كتاب أو مجلة. وهي تتضمن بيانات وصفية مثل العنوان والمؤلف، بالإضافة إلى بيانات شخصية، مثل ما إذا كان قد تم شراء المنتج أم لا. (يتم ذِكر حقول الحجم المتوفرة في عرض 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 المعرّف الفريد للقرص (في وضع العرض البسيط)
etag string معرّف غير شفاف لإصدار معيّن من مورد وحدة تخزين (في العرض المميّز بدقة منخفضة)
volumeInfo object معلومات عامة عن الحجم
volumeInfo.title string عنوان المجلد (في العرض المُبسّط)
volumeInfo.subtitle string العنوان الفرعي للحجم (في وضع العرض البسيط)
volumeInfo.authors[] list أسماء المؤلفين و/أو المحررين لهذا المجلد (في العرض المميّز)
volumeInfo.publisher string ناشر هذا المجلد. (في العرض المُبسّط)
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 بكسل تقريبًا) (في الإسقاط البسيط)
volumeInfo.imageLinks.small string رابط الصورة لحجم صغير (عرض 300 بكسل تقريبًا) (في عرض LITE)
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 موضع القراءة الحالي للمستخدم في المجلد، إذا كان متوفّرًا (في العرض المُبسّط)
userInfo.isPurchased boolean ما إذا كان هذا المجلد قد تم شراؤه من قِبل المستخدم المُعتمَد الذي يقدّم الطلب أم لا (في وضع العرض البسيط)
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 المبلغ بالعملة المدرَجة أدناه (في وضع العرض البسيط)
saleInfo.listPrice.currencyCode string رمز عملة مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217 (في وضع العرض البسيط)
saleInfo.retailPrice object السعر الفعلي لبيع الكتاب. هذا السعر هو نفسه السعر المقترَح للبيع بالتجزئة أو السعر المحدَّد في القائمة، ما لم تكن هناك عروض أو خصومات على هذا العدد. (في عرض LITE)
saleInfo.retailPrice.amount double المبلغ بالعملة المدرَجة أدناه (في وضع العرض البسيط)
saleInfo.retailPrice.currencyCode string تمثّل هذه السمة رمز عملة مكوّنًا من ثلاثة أحرف وفقًا لمعيار ISO 4217. (في العرض المُبسّط)
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 (في عرض LITE)
accessInfo.pdf object معلومات حول محتوى ملف PDF (في الإسقاط البسيط)
accessInfo.accessViewStatus string تجمع هذه السمة بين إمكانية الوصول إلى هذا المجلد وإمكانية عرضه في حقل حالة واحد لهذا المستخدم. يمكن أن تكون القيم FULL_PURCHASED أو FULL_PUBLIC_DOMAIN أو SAMPLE أو NONE. (في عرض LITE).
accessInfo.embeddable boolean تحدِّد هذه السياسة ما إذا كان من الممكن تضمين هذا المجلد في إطار عرض باستخدام Embed Viewer API.
accessInfo.publicDomain boolean ما إذا كان هذا الكتاب متاحًا في نطاق عام في البلد المدرَج أعلاه أم لا
userInfo.updated datetime طابع زمني لآخر تعديل لهذا المجلد من خلال إجراء اتخذه المستخدم، مثل تعديل موضع القراءة أو شراء مجلّد أو كتابة مراجعة (تنسيق الوقت والتاريخ RFC 3339 UTC)
userInfo.isPreordered boolean ما إذا كان هذا المجلد قد تم طلبه مسبقًا من قِبل المستخدم المُعتمَد الذي يقدّم الطلب أم لا (في وضع العرض البسيط)
saleInfo.onSaleDate datetime تاريخ توفّر هذا الكتاب للبيع.
accessInfo.textToSpeechPermission string ما إذا كان يُسمح باستخدام ميزة "تحويل النص إلى كلام" في هذا المجلد يمكن أن تكون القيم ALLOWED أو ALLOWED_FOR_ACCESSIBILITY أو NOT_ALLOWED.
accessInfo.epub.isAvailable boolean هل ملف epub بنص متدفق متاح إما ضمن النطاق العام أو للشراء. (في عرض LITE).
accessInfo.pdf.isAvailable boolean هل ملف PDF صورة ممسوحة ضوئيًا متاح إما ضمن النطاق العام أو للشراء. (في العرض المُبسّط)
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 مقتطف نصي يحتوي على طلب البحث