رف الكتب: الحصول على
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسترجع مورد رفّ الكتب محدّدًا للمستخدم المحدّد.
التجربة الآن
يمكن العثور على مزيد من المعلومات عن أرقام تعريف المستخدمين في قسم أرقام تعريف "كتب Google".
الطلب
طلب HTTP
GET https://www.googleapis.com/books/v1/users/userId/bookshelves/shelf
المعلمات
اسم المَعلمة |
القيمة |
الوصف |
المَعلمات المطلوبة |
shelf |
string |
رقم تعريف رف الكتب المطلوب استرجاعه
|
userId |
string |
رقم تعريف المستخدم الذي يمكن استرداد رفوف الكتب له.
|
المَعلمات الاختيارية |
source |
string |
سلسلة لتحديد مصدر هذا الطلب
|
نص الطلب
لا تقدِّم نص طلب باستخدام هذه الطريقة.
الرد
إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة مرجع رفّ الكتب في نص الاستجابة.
جرِّبها
استخدِم أداة الاستكشاف أدناه لاستدعاء هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a specific bookshelf resource for a given user using their user ID and bookshelf ID.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include the bookshelf ID (\u003ccode\u003eshelf\u003c/code\u003e), the user ID (\u003ccode\u003euserId\u003c/code\u003e), and an optional source parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request should be a GET request to the specified URL with the parameters provided.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns a Bookshelf resource with information about the requested bookshelf.\u003c/p\u003e\n"],["\u003cp\u003eNo request body is needed for this method.\u003c/p\u003e\n"]]],[],null,["# Bookshelf: get\n\nRetrieves a specific [Bookshelf resource](/books/docs/v1/reference/bookshelves) for the specified user.\n[Try it now](#try-it).\n\nMore information about user IDs can be found in the section [Google Books IDs](/books/docs/v1/using#ids).\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/books/v1/users/userId/bookshelves/shelf\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|----------|----------------------------------------------------|\n| **Required Parameters** |||\n| `shelf` | `string` | ID of bookshelf to retrieve. |\n| `userId` | `string` | ID of user for whom to retrieve bookshelves. |\n| **Optional Parameters** |||\n| `source` | `string` | String to identify the originator of this request. |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [Bookshelf resource](/books/docs/v1/reference/bookshelves#resource) in the response body.\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]