Mylibrary.bookshelf.volumes: Liste
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ruft Volume-Informationen für Volumes in einem Bücherregal ab.
Jetzt testen
Anfrage
HTTP-Request
GET https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/volumes
Parameter
Parametername |
Wert |
Beschreibung |
Erforderliche Parameter |
shelf |
string |
Die Buchreihen-ID oder der Name, für die bzw. den Bände abgerufen werden sollen.
|
Optionale Parameter |
maxResults |
unsigned integer |
Maximale Anzahl der zurückzugebenden Ergebnisse
|
projection |
string |
Zurückgegebene Informationen auf eine Reihe von ausgewählten Feldern beschränken.
Zulässige Werte sind:
- „
full “: Enthält alle Daten zum Volumen.
- „
lite “: Umfasst einen Teil der Felder in „volumeInfo“ und „accessInfo“.
|
q |
string |
Volltextsuchabfragestring in dieser Bücherei.
|
showPreorders |
boolean |
Legen Sie „wahr“ fest, um vorbestellte Bücher anzuzeigen. Die Standardeinstellung ist "false".
|
source |
string |
String zur Identifizierung des Urhebers dieser Anfrage.
|
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 größer als die Anzahl der Volumes sein, die in dieser Antwort zurückgegeben werden, wenn die Ergebnisse paginiert wurden. |
|
items[] |
list |
Eine Liste von Bänden. |
|
Testen!
Verwenden Sie den explorativen Datenanalysetool unten, um diese Methode auf Live-Daten anzuwenden und die Antwort zu sehen.
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 volume information for books on a specific bookshelf.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by search query, pre-orders, and selected fields.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of volumes with details like total items and individual volume resources.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination for handling large results.\u003c/p\u003e\n"],["\u003cp\u003eCan be tested using the provided interactive explorer.\u003c/p\u003e\n"]]],[],null,["# Mylibrary.bookshelves.volumes: list\n\nGets volume information for volumes on a bookshelf.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/volumes\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-----------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `shelf` | `string` | The bookshelf ID or name retrieve volumes for. |\n| **Optional Parameters** |||\n| `maxResults` | `unsigned integer` | Maximum number of results to return |\n| `projection` | `string` | Restrict information returned to a set of selected fields. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`full`\" - Includes all volume data. - \"`lite`\" - Includes a subset of fields in volumeInfo and accessInfo. |\n| `q` | `string` | Full-text search query string in this bookshelf. |\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."]]