مستوى الصوت: قائمة

يُجري عملية بحث عن كتاب. جرِّب ذلك الآن.

الطلب

طلب HTTP

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

المعلمات

اسم المَعلمة القيمة الوصف
المَعلمات المطلوبة
q string سلسلة طلب البحث في النص الكامل
المَعلمات الاختيارية
download string تقييد المحتوى على وحدات التخزين حسب مدى توفّر التنزيل

القِيَم المقبولة هي:
  • "epub": جميع الأجزاء بتنسيق epub
filter string فلترة نتائج البحث

في ما يلي القيم المقبولة:
  • "ebooks": جميع الكتب الإلكترونية من Google
  • "free-ebooks": كتاب إلكتروني من Google يتيح إمكانية عرض النص بمستوى الصوت الكامل
  • "full": يمكن للجميع الاطّلاع على نص المجلد بالكامل.
  • "paid-ebooks" - كتاب إلكتروني من Google بسعر
  • "partial": يمكن للجميع الاطّلاع على أجزاء من النص.
langRestrict string حصر النتائج على الكتب التي تحتوي على رمز اللغة هذا
libraryRestrict string حصر البحث في مكتبة هذا المستخدم

القِيَم المقبولة هي:
  • "my-library": التقييد بمكتبة المستخدم أو أي رف
  • "no-restrict" - عدم التقييد استنادًا إلى مكتبة المستخدم.
maxResults unsigned integer الحد الأقصى لعدد النتائج المطلوب عرضها. القيم المقبولة هي من 0 إلى 40.
orderBy string ترتيب نتائج البحث

القِيَم المقبولة هي:
  • "newest": آخر إصدار منشور
  • "relevance": مدى الصلة بعبارات البحث
partner string حصر نتائج معرّف الشريك ووضع علامة تجارية عليها
printType string حصر المحتوى بالكتب أو المجلات

القِيَم المقبولة هي:
  • "all": كل أنواع المحتوى الخاص بالصوت
  • "books": الكتب فقط
  • "magazines": مجلات فقط
projection string تستخدم لتقييد المعلومات التي يتم عرضها لمجموعة من الحقول المحددة.

القِيَم المقبولة هي:
  • "full": يتضمّن جميع بيانات عدد الزيارات.
  • "lite": تتضمّن مجموعة فرعية من الحقول في volumeInfo وaccessInfo.
showPreorders boolean اضبط هذا الخيار على "صحيح" لعرض الكتب المتوفّرة للطلب المُسبَق. القيمة التلقائية هي false.
source string سلسلة لتحديد مصدر هذا الطلب.
startIndex unsigned integer فهرس أول نتيجة يتم عرضها (يبدأ من 0)

نص الطلب

لا تقدِّم محتوى طلب باستخدام هذه الطريقة.

الرد

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
اسم الموقع القيمة الوصف ملاحظات
kind string نوع المورد
items[] list قائمة بالمجلدات
totalItems integer إجمالي عدد المجلدات التي تم العثور عليها قد يكون هذا العدد أكبر من عدد الأجزاء التي تم عرضها في هذا الردّ إذا تم تقسيم النتائج إلى صفحات.

جرِّبها

استخدِم أداة الاستكشاف أدناه لاستدعاء هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.