مستوى الصوت

تُستخدَم مجموعة 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
  }
}
اسم الموقع القيمة الوصف Notes
kind string نوع المورِد لمجلد (في عرض LITE).
id string معرّف فريد لوحدة تخزين (في عرض LITE).
etag string معرّف معتم لإصدار معيّن من مورد وحدة تخزين (في عرض 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.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 الفئة الرئيسية التي ينتمي إليها هذا المجلد. وستكون الفئة من قائمة الفئات المعروضة أدناه ذات الأهمية الأكبر.
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).
accessInfo object يشير هذا المصطلح إلى أي معلومات عن مجلد معيّن ذات صلة بقراءة النص الخاص بهذا الجزء أو الحصول عليه. وقد تعتمد هذه المعلومات على البلد (قد تكون الكتب ضمن نطاق عام في بلد ما ولكن ليس في بلد آخر مثلاً).
accessInfo.country string رمز البلد المكوّن من حرفين وفقًا لمعيار ISO_3166-1 والذي تكون معلومات الوصول هذه صالحة له. (في عرض LITE).
accessInfo.viewability string الإذن بقراءة جزء ما. القيم المحتملة هي PARTIAL أو ALL_pages أو NO_pages أو UNKNOWN. وتعتمد هذه القيمة على البلد المذكور أعلاه. وتعني القيمة "جزئيًا" أنّ الناشر سمح بعرض جزء من المجلد للجمهور بدون الحاجة إلى شرائه. ويمكن أن ينطبق ذلك على الكتب الإلكترونية وغيرها من الكتب. ستحتوي كتب النطاق العام دائمًا على قيمة ALL_pages.
accessInfo.epub object معلومات عن محتوى EPUB (في عرض LITE)
accessInfo.pdf object معلومات حول محتوى ملف PDF (في عرض LITE)
accessInfo.accessViewStatus string يجمع بين إمكانية الوصول إلى هذا المجلد وإمكانية عرضه في حقل حالة واحد لهذا المستخدم. يمكن أن تكون القيم FULL_PURCHASED أو FULL_PUBLIC_DOMAIN أو SAMPLE أو NONE. (في عرض LITE).
accessInfo.embeddable boolean تحدِّد هذه السياسة ما إذا كان من الممكن تضمين هذا المجلد في إطار عرض باستخدام Include Viewer API.
accessInfo.publicDomain boolean ما إذا كان هذا الكتاب ضمن نطاق عام في البلد المذكور أعلاه أم لا.
userInfo.updated datetime طابع زمني لآخر تعديل لهذا المجلد من خلال إجراء اتخذه المستخدم، مثل تعديل موضع القراءة أو شراء مجلّد أو كتابة مراجعة (تنسيق الوقت والتاريخ RFC 3339 UTC)
userInfo.isPreordered boolean ما إذا كان قد تم طلب هذا المجلد مسبقًا من قِبل المستخدم الذي تمت المصادقة عليه والذي قدّم الطلب. (في عرض LITE).
saleInfo.onSaleDate datetime التاريخ الذي سيكون فيه هذا الكتاب متاحًا للبيع.
accessInfo.textToSpeechPermission string ما إذا كان تحويل النص إلى كلام مسموح به لهذا المجلد. يمكن أن تكون القيم Allow_FOR_ACCESSIBILITY أو Allowed_FOR_ACCESSIBILITY.
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 إذا كان الجهاز مسموحًا به، يوضّح ما إذا كان قد تم الحصول على إمكانية الوصول للتو من خلال هذا الطلب.
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 مقتطف نصي يحتوي على طلب البحث