Volume: elenco
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Esegue una ricerca di libri.
Prova subito.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
Parametri
| Nome parametro |
Valore |
Descrizione |
| Parametri obbligatori |
q |
string |
Stringa della query di ricerca a testo intero.
|
| Parametri facoltativi |
download |
string |
Limita ai volumi in base alla disponibilità di download.
I valori accettati sono:
- "
epub": tutti i volumi con epub.
|
filter |
string |
Filtrare i risultati di ricerca.
I valori accettati sono:
- "
ebooks": tutti gli ebook di Google.
- "
free-ebooks": eBook Google con visibilità del testo a volume massimo.
- "
full": il pubblico può visualizzare il testo dell'intero volume.
- "
paid-ebooks": eBook Google con un prezzo.
- "
partial": il pubblico può vedere parti del testo.
|
langRestrict |
string |
Limita i risultati ai libri con questo codice lingua.
|
libraryRestrict |
string |
Limita la ricerca alla raccolta di questo utente.
I valori accettati sono:
- "
my-library": limita la visualizzazione alla raccolta dell'utente, a qualsiasi sezione.
- "
no-restrict": non applicare limitazioni in base alla raccolta dell'utente.
|
maxResults |
unsigned integer |
Il numero massimo di risultati da restituire.
I valori accettabili sono compresi tra 0 e 40.
|
orderBy |
string |
Ordina i risultati di ricerca.
I valori accettati sono:
- "
newest": pubblicato più di recente.
- "
relevance": pertinenza ai termini di ricerca.
|
partner |
string |
Limita e personalizza i risultati per l'ID partner.
|
printType |
string |
Limitare a libri o riviste.
I valori accettati sono:
- "
all": tutti i tipi di contenuti del volume.
- "
books" - Solo libri.
- "
magazines": solo riviste.
|
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.
|
showPreorders |
boolean |
Imposta il valore true per mostrare i libri disponibili per la prenotazione. Il valore predefinito è false.
|
source |
string |
Stringa per identificare l'autore della richiesta.
|
startIndex |
unsigned integer |
Indice del primo risultato da restituire (inizia da 0)
|
Corpo della richiesta
Non specificare 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",
"items": [
volume Resource
],
"totalItems": (value)
}
| Nome proprietà |
Valore |
Descrizione |
Note |
kind |
string |
Tipo di risorsa. |
|
items[] |
list |
Un elenco di volumi. |
|
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. |
|
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\u003eSearches for books based on a provided query string.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by criteria such as availability, format, language, and publication type.\u003c/p\u003e\n"],["\u003cp\u003eOffers control over the number of results, sorting order, and specific data fields returned.\u003c/p\u003e\n"],["\u003cp\u003eCan be used to retrieve information about books, including volume details and access options.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to handle large result sets.\u003c/p\u003e\n"]]],[],null,["# Volume: list\n\nPerforms a book search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n GET https://www.googleapis.com/books/v1/volumes?q={search terms}\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-------------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `q` | `string` | Full-text search query string. |\n| **Optional Parameters** |||\n| `download` | `string` | Restrict to volumes by download availability. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`epub`\" - All volumes with epub. |\n| `filter` | `string` | Filter search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`ebooks`\" - All Google eBooks. - \"`free-ebooks`\" - Google eBook with full volume text viewability. - \"`full`\" - Public can view entire volume text. - \"`paid-ebooks`\" - Google eBook with a price. - \"`partial`\" - Public able to see parts of text. |\n| `langRestrict` | `string` | Restrict results to books with this language code. |\n| `libraryRestrict` | `string` | Restrict search to this user's library. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`my-library`\" - Restrict to the user's library, any shelf. - \"`no-restrict`\" - Do not restrict based on user's library. |\n| `maxResults` | `unsigned integer` | Maximum number of results to return. Acceptable values are `0` to `40`, inclusive. |\n| `orderBy` | `string` | Sort search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`newest`\" - Most recently published. - \"`relevance`\" - Relevance to search terms. |\n| `partner` | `string` | Restrict and brand results for partner ID. |\n| `printType` | `string` | Restrict to books or magazines. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\" - All volume content types. - \"`books`\" - Just books. - \"`magazines`\" - Just magazines. |\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| `showPreorders` | `boolean` | Set to true to show books available for preorder. Defaults to false. |\n| `source` | `string` | String to identify the originator of this request. |\n| `startIndex` | `unsigned integer` | Index of the first result 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 {\n \"kind\": \"books#volumes\",\n \"items\": [\n volume Resource\n ],\n \"totalItems\": (value)\n }\n\n| Property Name | Value | Description | Notes |\n|---------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `items[]` | `list` | A list of volumes. | |\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\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]
