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

لإجراء بحث عن كتاب. تجربة ذلك الآن

الطلب

طلب 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": يتضمن مجموعة فرعية من الحقول في lengthInfo وaccessInfo.
showPreorders boolean يمكنك الضبط على "صحيح" لعرض الكتب المتاحة للطلب المسبق. وتكون القيمة التلقائية على "خطأ".
source string سلسلة لتحديد مصدر هذا الطلب.
startIndex unsigned integer فهرس النتيجة الأولى المطلوب عرضها (يبدأ من 0)

نص الطلب

لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.

الإجابة

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

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

جرِّبها

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