Bücherregale.Volumes: Liste
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ruft Bände in einem bestimmten Bücherregal für den angegebenen Nutzer ab.
Jetzt testen
Anfrage
HTTP-Request
GET https://www.googleapis.com/books/v1/users/userId/bookshelves/shelf/volumes
Parameter
Parametername |
Wert |
Beschreibung |
Erforderliche Parameter |
shelf |
string |
ID der Buchhandlung, aus der Bände abgerufen werden sollen.
|
userId |
string |
ID des Nutzers, für den Bücherregal-Volumes abgerufen werden sollen.
|
Optionale Parameter |
maxResults |
unsigned integer |
Maximale Anzahl der zurückzugebenden Ergebnisse
|
showPreorders |
boolean |
Legen Sie „wahr“ fest, um vorbestellte Bücher anzuzeigen. Die Standardeinstellung ist "false".
|
source |
string |
String, mit dem der Absender dieser Anfrage identifiziert wird.
|
startIndex |
unsigned integer |
Index des ersten Elements, das zurückgegeben werden soll (beginnt bei 0)
|
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{
"kind": "books#volumes",
"totalItems": integer,
"items": [
volumes Resource
]
}
Property-Name |
Wert |
Beschreibung |
Hinweise |
kind |
string |
Ressourcentyp. |
|
totalItems |
integer |
Gesamtzahl der gefundenen Volumes. Dieser Wert kann höher sein als die Anzahl der Bände, die in dieser Antwort zurückgegeben werden, wenn die Ergebnisse auf mehrere Seiten verteilt wurden. |
|
items[] |
list |
Eine Liste von Volumes. |
|
Testen!
Rufen Sie diese Methode mit dem Explorer unten für Live-Daten auf und sehen Sie sich die Antwort an.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-11-08 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-11-08 (UTC)."],[[["\u003cp\u003eRetrieves a list of books from a specific bookshelf belonging to a given user.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by parameters such as maximum results, pre-orders, and starting index for pagination.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes the total number of books found and a list of book details.\u003c/p\u003e\n"],["\u003cp\u003eYou can interactively try this method using the provided explorer to test it with live data.\u003c/p\u003e\n"]]],[],null,["# Bookshelves.volumes: list\n\nRetrieves volumes in a specific bookshelf for the specified user.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/books/v1/users/userId/bookshelves/shelf/volumes\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-----------------|--------------------|-----------------------------------------------------------|\n| **Required Parameters** |||\n| `shelf` | `string` | ID of bookshelf to retrieve volumes. |\n| `userId` | `string` | ID of user for whom to retrieve bookshelf volumes. |\n| **Optional Parameters** |||\n| `maxResults` | `unsigned integer` | Maximum number of results to return |\n| `showPreorders` | `boolean` | Set to true to show pre-ordered books. Defaults to false. |\n| `source` | `string` | String to identify the originator of this request. |\n| `startIndex` | `unsigned integer` | Index of the first element to return (starts at 0) |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"books#volumes\",\n \"totalItems\": integer,\n \"items\": [\n volumes Resource\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|---------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `totalItems` | `integer` | Total number of volumes found. This might be greater than the number of volumes returned in this response if results have been paginated. | |\n| `items[]` | `list` | A list of volumes. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]