يُجري عملية بحث عن كتاب. جرِّب ذلك الآن.
الطلب
طلب HTTP
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
المعلمات
اسم المَعلمة | القيمة | الوصف |
---|---|---|
المَعلمات المطلوبة | ||
q |
string |
سلسلة طلب البحث في النص الكامل |
المَعلمات الاختيارية | ||
download |
string |
تقييد المحتوى على وحدات التخزين حسب مدى توفّر التنزيل
القِيَم المقبولة هي:
|
filter |
string |
فلترة نتائج البحث
في ما يلي القيم المقبولة:
|
langRestrict |
string |
حصر النتائج على الكتب التي تحتوي على رمز اللغة هذا |
libraryRestrict |
string |
حصر البحث في مكتبة هذا المستخدم
القِيَم المقبولة هي:
|
maxResults |
unsigned integer |
الحد الأقصى لعدد النتائج المطلوب عرضها.
القيم المقبولة هي من 0 إلى 40 .
|
orderBy |
string |
ترتيب نتائج البحث
القِيَم المقبولة هي:
|
partner |
string |
حصر نتائج معرّف الشريك ووضع علامة تجارية عليها |
printType |
string |
حصر المحتوى بالكتب أو المجلات
القِيَم المقبولة هي:
|
projection |
string |
تستخدم لتقييد المعلومات التي يتم عرضها لمجموعة من الحقول المحددة.
القِيَم المقبولة هي:
|
showPreorders |
boolean |
اضبط هذا الخيار على "صحيح" لعرض الكتب المتوفّرة للطلب المُسبَق. القيمة التلقائية هي false. |
source |
string |
سلسلة لتحديد مصدر هذا الطلب. |
startIndex |
unsigned integer |
فهرس أول نتيجة يتم عرضها (يبدأ من 0) |
نص الطلب
لا تقدِّم محتوى طلب باستخدام هذه الطريقة.
الرد
إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:
{
"kind": "books#volumes",
"items": [
volume Resource
],
"totalItems":(value)
}
اسم الموقع | القيمة | الوصف | ملاحظات |
---|---|---|---|
kind |
string |
نوع المورد | |
items[] |
list |
قائمة بالمجلدات | |
totalItems |
integer |
إجمالي عدد المجلدات التي تم العثور عليها قد يكون هذا العدد أكبر من عدد الأجزاء التي تم عرضها في هذا الردّ إذا تم تقسيم النتائج إلى صفحات. |
جرِّبها
استخدِم أداة الاستكشاف أدناه لاستدعاء هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.