Mylibrary.bookshelves: moveVolume
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتطلّب تفويضًا
نقل مجلد ضمن رف كتب
جرِّب ذلك الآن.
الطلب
طلب HTTP
POST https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/moveVolume
المعلمات
| اسم المَعلمة |
القيمة |
الوصف |
| المَعلمات المطلوبة |
shelf |
string |
معرّف رف الكتب الذي يتضمّن المجلد
|
volumeId |
string |
رقم تعريف وحدة التخزين المطلوب نقلها
|
volumePosition |
integer |
موضع الرف لنقل السلعة (يؤدي الرمز 0 إلى وضع السلعة قبل السلعة الأولى الحالية، ويؤدي الرمز 1 إلى وضعها بين السلعة الأولى والثانية وما إلى ذلك).
|
| المَعلمات الاختيارية |
source |
string |
سلسلة لتحديد مصدر هذا الطلب
|
التفويض
يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية (اطّلِع على مزيد من المعلومات عن المصادقة والتفويض).
| النطاق |
|---|
https://www.googleapis.com/auth/books |
نص الطلب
لا تقدِّم محتوى طلب باستخدام هذه الطريقة.
الرد
إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة فارغًا.
جرِّبها
استخدِم أداة الاستكشاف أدناه لاستدعاء هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eMoves a volume to a different position within a specified bookshelf in your Google Books library.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/books\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request specifies the shelf ID, volume ID, and the desired position within the shelf.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to the \u003ccode\u003ehttps://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/moveVolume\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns an empty response body, indicating the volume has been moved.\u003c/p\u003e\n"]]],[],null,["# Mylibrary.bookshelves: moveVolume\n\n**Requires [authorization](#auth)**\n\nMoves a volume within a bookshelf.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n```\nPOST https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/moveVolume\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `shelf` | `string` | ID of bookshelf with the volume. |\n| `volumeId` | `string` | ID of volume to move. |\n| `volumePosition` | `integer` | Position on shelf to move the item (0 puts the item before the current first item, 1 puts it between the first and the second and so on.) |\n| **Optional Parameters** |||\n| `source` | `string` | String to identify the originator of this request. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/books/docs/v1/using#auth)).\n\n| Scope |\n|-----------------------------------------|\n| `https://www.googleapis.com/auth/books` |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns an empty response body.\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]
