Volume: elenco

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 Filtra i risultati di ricerca.

I valori accettati sono:
  • "ebooks" - Tutti i Google eBook.
  • "free-ebooks" - Google eBook con visibilità del testo a tutto volume.
  • "full": il pubblico può visualizzare il testo dell'intero volume.
  • "paid-ebooks" - Google eBook 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": consente di limitare l'accesso alla raccolta o a qualsiasi sezione dell'utente.
  • "no-restrict" - Non limitare in base alla raccolta dell'utente.
maxResults unsigned integer Numero massimo di risultati da restituire. I valori accettati sono compresi tra 0 e 40 (inclusi).
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 i risultati e applica il brand per l'ID partner.
printType string Limita ai libri o alle riviste.

I valori accettati sono:
  • "all" - Tutti i tipi di contenuti di 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 di 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 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",
  "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 lo strumento di esplorazione in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.