Volume

Una raccolta Volume viene utilizzata per eseguire una ricerca o elencare i contenuti di uno scaffale. Questa raccolta è di sola lettura.

Metodi

I seguenti metodi si applicano ai dati pubblici sui volumi e non richiedono l'autenticazione.
books.volumes.list
books.volumes.get

Il seguente metodo si applica alla visualizzazione privata dei volumi "La mia raccolta" e richiede l'autenticazione.
books.mylibrary.bookshelves.volumes.list

trova
Recupera una risorsa di volume in base all'ID.
list
Esegue una ricerca di libri.

Rappresentazioni delle risorse

Un volume rappresenta informazioni su un libro o una rivista in Google Libri. Contiene metadati, come titolo e autore, nonché dati personalizzati, ad esempio se è stato acquistato o meno. I campi del volume disponibili nella proiezione LITE sono riportati di seguito.

{
  "kind": "books#volume",
  "id": string,
  "etag": string,
  "selfLink": string,
  "volumeInfo": {
    "title": string,
    "subtitle": string,
    "authors": [
      string
    ],
    "publisher": string,
    "publishedDate": string,
    "description": string,
    "industryIdentifiers": [
      {
        "type": string,
        "identifier": string
      }
    ],
    "pageCount": integer,
    "dimensions": {
      "height": string,
      "width": string,
      "thickness": string
    },
    "printType": string,
    "mainCategory": string,
    "categories": [
      string
    ],
    "averageRating": double,
    "ratingsCount": integer,
    "contentVersion": string,
    "imageLinks": {
      "smallThumbnail": string,
      "thumbnail": string,
      "small": string,
      "medium": string,
      "large": string,
      "extraLarge": string
    },
    "language": string,
    "previewLink": string,
    "infoLink": string,
    "canonicalVolumeLink": string
  },
  "userInfo": {
    "review": mylibrary.reviews Resource,
    "readingPosition": mylibrary.readingpositions Resource,
    "isPurchased": boolean,
    "isPreordered": boolean,
    "updated": datetime
  },
  "saleInfo": {
    "country": string,
    "saleability": string,
    "onSaleDate": datetime,
    "isEbook": boolean,
    "listPrice": {
      "amount": double,
      "currencyCode": string
    },
    "retailPrice": {
      "amount": double,
      "currencyCode": string
    },
    "buyLink": string
  },
  "accessInfo": {
    "country": string,
    "viewability": string,
    "embeddable": boolean,
    "publicDomain": boolean,
    "textToSpeechPermission": string,
    "epub": {
      "isAvailable": boolean,
      "downloadLink": string,
      "acsTokenLink": string
    },
    "pdf": {
      "isAvailable": boolean,
      "downloadLink": string,
      "acsTokenLink": string
    },
    "webReaderLink": string,
    "accessViewStatus": string,
    "downloadAccess": {
      "kind": "books#downloadAccessRestriction",
      "volumeId": string,
      "restricted": boolean,
      "deviceAllowed": boolean,
      "justAcquired": boolean,
      "maxDownloadDevices": integer,
      "downloadsAcquired": integer,
      "nonce": string,
      "source": string,
      "reasonCode": string,
      "message": string,
      "signature": string
    }
  },
  "searchInfo": {
    "textSnippet": string
  }
}
Nome proprietà Valore Descrizione Note
kind string Tipo di risorsa per un volume. (proiezione in LITE).
id string Identificatore univoco per un volume. (proiezione in LITE).
etag string Identificatore opaco per una versione specifica di una risorsa di volume. (Proiezione in LITE)
volumeInfo object Informazioni generali sul volume.
volumeInfo.title string Titolo del volume. (proiezione in LITE).
volumeInfo.subtitle string Sottotitolo del volume. (proiezione in LITE).
volumeInfo.authors[] list I nomi degli autori e/o dei curatori di questo volume. (Proiezione in LITE)
volumeInfo.publisher string Editore di questo volume. (proiezione in LITE).
volumeInfo.publishedDate string Data di pubblicazione. (proiezione in LITE).
volumeInfo.description string Un riepilogo del volume. Il testo della descrizione è formattato in HTML e include elementi di formattazione semplici, come i tag b, i e br. (proiezione LITE)
volumeInfo.industryIdentifiers[] list Identificatori standard di settore per questo volume.
volumeInfo.industryIdentifiers[].type string Tipo di identificatore. I valori possibili sono ISBN_10, ISBN_13, ISSN e OTHER.
volumeInfo.industryIdentifiers[].identifier string Identificatore del volume specifico del settore.
volumeInfo.pageCount integer Numero totale di pagine.
volumeInfo.dimensions object Dimensioni fisiche di questo volume.
volumeInfo.dimensions.height string Altezza o lunghezza di questo volume (in cm).
volumeInfo.dimensions.width string Larghezza di questo volume (in cm).
volumeInfo.dimensions.thickness string Spessore di questo volume (in cm).
volumeInfo.printType string Tipo di pubblicazione di questo volume. I valori possibili sono BOOK o MAGAZINE.
volumeInfo.categories[] list Un elenco di categorie di argomenti, come "Fiction", "Suspense" e così via.
volumeInfo.averageRating double La valutazione media delle recensioni per questo volume. (min = 1,0, max = 5,0)
volumeInfo.ratingsCount integer Il numero di valutazioni delle recensioni per questo volume.
volumeInfo.contentVersion string Un identificatore della versione dei contenuti del volume (testo e immagini). (Proiezione in LITE)
volumeInfo.imageLinks.thumbnail string Link immagine per le dimensioni della miniatura (larghezza di circa 128 pixel). (proiezione LITE)
volumeInfo.imageLinks.small string Link immagine per dimensioni ridotte (larghezza di circa 300 pixel). (proiezione LITE)
volumeInfo.imageLinks.medium string Link immagine per dimensioni medie (larghezza di circa 575 pixel). (proiezione LITE)
volumeInfo.imageLinks.large string Link immagine per dimensioni grandi (larghezza di circa 800 pixel). (proiezione LITE)
volumeInfo.imageLinks.smallThumbnail string Link immagine per miniature di dimensioni ridotte (larghezza di circa 80 pixel). (proiezione LITE)
volumeInfo.imageLinks.extraLarge string Link immagine per dimensioni molto grandi (larghezza di circa 1280 pixel). (proiezione LITE)
volumeInfo.language string Lingua migliore per questo volume (in base ai contenuti). Si tratta del codice ISO 639-1 di due lettere, ad esempio "fr", "en" e così via.
volumeInfo.mainCategory string La categoria principale a cui appartiene questo volume. Sarà la categoria con la ponderazione più elevata dell'elenco di categorie restituito di seguito.
userInfo object Informazioni specifiche dell'utente relative a questo volume. (ad es. l'ultima pagina che l'utente ha letto o se ha acquistato il libro)
userInfo.review nested object Recensione di questo utente di questo volume, se esistente.
userInfo.readingPosition readingPosition Resource La posizione di lettura corrente dell'utente nel volume, se disponibile. (proiezione in LITE).
userInfo.isPurchased boolean Se il volume è stato acquistato o meno dall'utente autenticato che ha effettuato la richiesta. (proiezione in LITE).
saleInfo object Qualsiasi informazione su un volume correlato all'eBookstore e/o alla possibilità di acquisto. Queste informazioni possono dipendere dal paese da cui proviene la richiesta (ad esempio i libri potrebbero non essere in vendita in alcuni paesi).
saleInfo.country string Il codice paese ISO_3166-1 di due lettere per il quale sono valide queste informazioni di vendita. (proiezione in LITE).
saleInfo.saleability string Indica se il libro è disponibile per la vendita o viene offerto senza costi nel Google eBookstore per il paese sopra elencato. I valori possibili sono FOR_SALE, FREE, NOT_FOR_SALE o FOR_PREORDER.
saleInfo.isEbook boolean Indica se il volume è un eBook (può essere aggiunto allo scaffale I miei eBook).
saleInfo.listPrice object Prezzo di vendita suggerito. (proiezione LITE)
saleInfo.listPrice.amount double Importo nella valuta indicata di seguito. (proiezione in LITE).
saleInfo.listPrice.currencyCode string Un codice valuta ISO 4217 di tre lettere. (proiezione in LITE).
saleInfo.retailPrice object Il prezzo di vendita effettivo del libro. È uguale al prezzo di listino o al dettaglio suggerito, a meno che non ci siano offerte o sconti per questo volume. (proiezione LITE)
saleInfo.retailPrice.amount double Importo nella valuta indicata di seguito. (proiezione in LITE).
saleInfo.retailPrice.currencyCode string Un codice valuta ISO 4217 di tre lettere. (proiezione in LITE).
accessInfo object Qualsiasi informazione su un volume correlata alla lettura o al recupero del testo del volume. Queste informazioni possono dipendere dal paese (i libri possono essere di dominio pubblico in un paese, ma non in un altro, ad esempio).
accessInfo.country string Il codice paese ISO_3166-1 di due lettere per cui queste informazioni di accesso sono valide. (proiezione in LITE).
accessInfo.viewability string L'accesso in lettura di un volume. I valori possibili sono PARTIAL, ALL_PAGE, NO_SITE o UNKNOWN. Questo valore dipende dal paese sopra indicato. Il valore PARTIAL indica che il publisher ha consentito la visualizzazione pubblica di una parte del volume, senza acquisto. Questo vale sia per gli ebook che per gli altri libri. I libri di dominio pubblico avranno sempre il valore ALL_PAGE.
accessInfo.epub object Informazioni sui contenuti epub. (proiezione LITE)
accessInfo.pdf object Informazioni sui contenuti PDF. (proiezione LITE)
accessInfo.accessViewStatus string Riunisce l'accesso e la visibilità di questo volume in un unico campo di stato per l'utente. I valori possono essere FULL_PURCHASED, FULL_PUBLIC_DOMAIN, sample o NONE. (proiezione in LITE).
accessInfo.embeddable boolean Indica se questo volume può essere incorporato in un'area visibile utilizzando l'API Embedded Viewer.
accessInfo.publicDomain boolean Indica se il libro è di dominio pubblico o meno nel paese sopra indicato.
userInfo.updated datetime Timestamp dell'ultima modifica di questo volume da parte di un'azione dell'utente, ad esempio un aggiornamento della posizione di lettura, l'acquisto di un volume o la scrittura di una recensione. (formato di data e ora RFC 3339 UTC).
userInfo.isPreordered boolean Se questo volume è stato prenotato o meno dall'utente autenticato che ha effettuato la richiesta. (proiezione in LITE).
saleInfo.onSaleDate datetime La data in cui il libro sarà disponibile per la vendita.
accessInfo.textToSpeechPermission string Indica se la sintesi vocale è consentita per questo volume. I valori possono essere ALLOWED, ALLOWED_FOR_ACCESSIBILITY o NOT_ALLOWED.
accessInfo.epub.isAvailable boolean È un epub con testo scorrevole disponibile come dominio pubblico o per l'acquisto. (proiezione in LITE).
accessInfo.pdf.isAvailable boolean Un PDF con immagini scansionate è disponibile come dominio pubblico o per l'acquisto. (proiezione in LITE).
accessInfo.downloadAccess nested object Informazioni sulle limitazioni di accesso alla licenza per il download di un volume.
accessInfo.downloadAccess.kind string Tipo di risorsa.
accessInfo.downloadAccess.volumeId string Identifica il volume a cui si applica questa voce.
accessInfo.downloadAccess.restricted boolean Indica se questo volume ha limitazioni di accesso per il download.
accessInfo.downloadAccess.deviceAllowed boolean Se limitato, indica se l'accesso è concesso o meno (utente, dispositivo, volume).
accessInfo.downloadAccess.justAcquired boolean Se deviceAllowed, indica se l'accesso è stato appena acquisito con questa richiesta.
accessInfo.downloadAccess.maxDownloadDevices integer Se limitato, il numero massimo di licenze per il download di contenuti per questo volume.
accessInfo.downloadAccess.downloadsAcquired integer Se limitato, il numero di licenze di download di contenuti già acquisite (incluso il cliente richiedente, se autorizzato).
accessInfo.downloadAccess.nonce string Nonce client per la verifica. Solo accesso in download e convalida client.
accessInfo.downloadAccess.source string Identificatore dell'app client per la verifica. Solo accesso in download e convalida client.
accessInfo.downloadAccess.reasonCode string Codice motivo di errore/avviso. In futuro potrebbero essere aggiunti altri codici. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_utilizzato_LAST_ACCESS
accessInfo.downloadAccess.message string Messaggio di errore/avviso.
accessInfo.downloadAccess.signature string Firma della risposta.
searchInfo object Informazioni sui risultati di ricerca relative a questo volume.
searchInfo.textSnippet string Uno snippet di testo contenente la query di ricerca.