المجلد: القائمة

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

طلب

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

نص الطلب

لا توفر نص طلب بهذه الطريقة.

الإجابة

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

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

جرّب بنفسك!

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