Mylibrary.bookshelling.volumes: elenco
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Recupera le informazioni sui volumi di una libreria.
Prova subito.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/volumes
Parametri
| Nome parametro |
Valore |
Descrizione |
| Parametri obbligatori |
shelf |
string |
L'ID o il nome dello scaffale per il recupero dei volumi.
|
| Parametri facoltativi |
maxResults |
unsigned integer |
Numero massimo di risultati da restituire
|
projection |
string |
Consente di limitare le informazioni restituite a un insieme di campi selezionati.
I valori accettati sono:
- "
full": include tutti i dati sul volume.
- "
lite": include un sottoinsieme di campi in volumeInfo e accessInfo.
|
q |
string |
Stringa della query di ricerca a testo intero in questo scaffale.
|
showPreorders |
boolean |
Imposta il valore true per mostrare i libri prenotati. Il valore predefinito è false.
|
source |
string |
Stringa per identificare l'autore di questa richiesta.
|
startIndex |
unsigned integer |
Indice del primo elemento da restituire (inizia da 0)
|
Corpo della richiesta
Non fornire un corpo della richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{
"kind": "books#volumes",
"totalItems": integer,
"items": [
volumes Resource
]
}
| Nome proprietà |
Valore |
Descrizione |
Note |
kind |
string |
Tipo di risorsa. |
|
totalItems |
integer |
Numero totale di volumi trovati. Questo numero potrebbe essere maggiore del numero di volumi restituiti in questa risposta se i risultati sono stati impaginati. |
|
items[] |
list |
Un elenco di volumi. |
|
Provalo!
Utilizza l'esploratore di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-11-08 UTC.
[null,null,["Ultimo aggiornamento 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."]]
