للحصول على معلومات عن المجلدات على رف كتب. جرِّب ذلك الآن.
الطلب
طلب 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 | 
        قائمة بالمجلدات | 
جرِّبها
استخدِم أداة الاستكشاف أدناه لاستدعاء هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.