للحصول على معلومات عن المجلدات على رف كتب. جرِّب ذلك الآن.
الطلب
طلب HTTP
GET https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/volumes
المعلمات
اسم المَعلمة | القيمة | الوصف |
---|---|---|
المَعلمات المطلوبة | ||
shelf |
string |
رقم تعريف أو اسم رفّ الكتب الذي يتم استرداد المجلدات له |
المَعلمات الاختيارية | ||
maxResults |
unsigned integer |
الحد الأقصى لعدد النتائج المطلوب عرضها |
projection |
string |
تستخدم لتقييد المعلومات التي يتم عرضها لمجموعة من الحقول المحددة.
القِيَم المقبولة هي:
|
q |
string |
سلسلة طلب البحث في النص الكامل في رف الكتب هذا. |
showPreorders |
boolean |
يجب ضبط القيمة على "صحيح" لعرض الكتب المطلوبة مسبقًا. القيمة التلقائية هي false. |
source |
string |
سلسلة لتحديد مصدر هذا الطلب |
startIndex |
unsigned integer |
فهرس العنصر الأول الذي سيتم إرجاعه (يبدأ من 0) |
نص الطلب
لا تقدِّم محتوى طلب باستخدام هذه الطريقة.
الرد
إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:
{ "kind": "books#volumes", "totalItems": integer, "items": [ volumes Resource ] }
اسم الموقع | القيمة | الوصف | ملاحظات |
---|---|---|---|
kind |
string |
نوع المورد | |
totalItems |
integer |
إجمالي عدد المجلدات التي تم العثور عليها قد يكون هذا أكبر من عدد المجلدات التي يتم عرضها في هذه الاستجابة إذا كانت النتائج مقسَّمة إلى صفحات. | |
items[] |
list |
قائمة بالمجلدات |
جرِّبها
استخدِم أداة الاستكشاف أدناه لاستدعاء هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.