Volume: elenco

Esegue una ricerca nel libro. Prova subito.

Risorse richieste:

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" - Google eBook con visibilità del testo a volume intero.
  • "full": pubblico può visualizzare l'intero testo del volume.
  • "paid-ebooks" - Google eBook con un prezzo.
  • "partial": pubblico in grado di 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 alla raccolta dell'utente e a qualsiasi scaffale.
  • "no-restrict" - Non limitare in base alla raccolta dell'utente.
maxResults unsigned integer Numero massimo di risultati da restituire. I valori accettabili sono compresi tra 0 e 40 compresi.
orderBy string Ordinare i risultati di ricerca.

I valori accettati sono:
  • "newest": pubblicato più di recente.
  • "relevance": pertinenza ai termini di ricerca.
partner string Limitare e brandizzare i risultati per l'ID partner.
printType string Limita a libri o riviste.

I valori accettati sono:
  • "all": tutti i tipi di contenuti in base al volume.
  • "books" - Solo libri.
  • "magazines" - Solo riviste.
projection string Limita le informazioni restituite a un insieme di campi selezionati.

I valori accettati sono:
  • "full": include tutti i dati del volume.
  • "lite": include un sottoinsieme di campi di volumeInfo e accessInfo.
showPreorders boolean Impostalo su vero 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 (a partire 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 di 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 dei volumi.
totalItems integer Numero totale di volumi trovati. Questo valore potrebbe essere maggiore del numero di volumi restituiti in questa risposta se i risultati sono stati impaginati.

Prova!

Utilizza lo strumento Explorer di seguito per richiamare questo metodo sui dati in tempo reale e visualizzare la risposta.