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