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 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.