لإجراء بحث عن كتاب. التجربة الآن
طلب
طلب 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 |
يمكنك ضبط القيمة على "true" لعرض الكتب المتاحة للطلب المسبق. إعداد القيمة التلقائية على "false". |
source |
string |
سلسلة لتحديد منشأ هذا الطلب. |
startIndex |
unsigned integer |
فهرس النتيجة الأولى المعروضة (يبدأ بـ 0) |
نص الطلب
لا توفر نص طلب بهذه الطريقة.
الإجابة
إذا نجحت هذه الطريقة، فإنها تعرض نص الاستجابة بالبنية التالية:
{
"kind": "books#volumes",
"items": [
volume Resource
],
"totalItems":(value)
}
اسم الموقع | القيمة | الوصف | ملاحظات |
---|---|---|---|
kind |
string |
نوع المورد. | |
items[] |
list |
قائمة بالمجلدات. | |
totalItems |
integer |
إجمالي عدد المجلدات التي تم العثور عليها وقد يزيد هذا العدد عن عدد المجلدات التي تم عرضها في هذه الاستجابة إذا كانت النتائج مقسّمة على صفحات. |
جرّب بنفسك!
استخدم المستكشف أدناه لاستدعاء هذه الطريقة في البيانات المباشرة والاطلاع على الاستجابة.