Mylibrary.bookshelves: moveVolume
Stay organized with collections
Save and categorize content based on your preferences.
Requires authorization
Moves a volume within a bookshelf.
Try it now.
Request
HTTP Request
POST https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/moveVolume
Parameters
| Parameter Name |
Value |
Description |
| Required Parameters |
shelf |
string |
ID of bookshelf with the volume.
|
volumeId |
string |
ID of volume to move.
|
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.)
|
| Optional Parameters |
source |
string |
String to identify the originator of this request.
|
Authorization
This request requires authorization with at least one of the following scopes (read more about authentication and authorization).
| Scope |
|---|
https://www.googleapis.com/auth/books |
Request Body
Do not supply a request body with this method.
Response
If successful, this method returns an empty response body.
Try It!
Use the explorer below to call this method on live data and see the response.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-26 UTC.
[null,null,["Last updated 2024-06-26 UTC."],[[["\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."]]