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.listbooks.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) | |
selfLink |
string |
URL a questa risorsa. (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 |
object |
Un elenco di link immagine per tutte le dimensioni disponibili. (proiezione 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. | |
volumeInfo.previewLink |
string |
URL per visualizzare l'anteprima di questo volume sul sito di Google Libri. | |
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). | |
saleInfo.buyLink |
string |
URL per acquistare questo volume sul sito di Google Libri. (proiezione 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.epub.downloadLink |
string |
URL per scaricare l'epub. (proiezione in LITE). | |
accessInfo.epub.acsTokenLink |
string |
URL per recuperare il token ACS per il download dell'epub. (proiezione in LITE). | |
accessInfo.pdf |
object |
Informazioni sui contenuti PDF. (proiezione LITE) | |
accessInfo.pdf.downloadLink |
string |
URL per scaricare il PDF. (proiezione in LITE). | |
accessInfo.pdf.acsTokenLink |
string |
URL per recuperare il token ACS per il download del PDF. (proiezione in 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. | |
|
string |
URL per visualizzare informazioni su questo volume sul sito di Google Libri. (Proiezione in LITE) | |
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). | |
volumeInfo.canonicalVolumeLink |
string |
URL canonico per un volume. (proiezione in LITE). | |
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.webReaderLink |
string |
URL per leggere questo volume sul sito di Google Libri. Il link non consentirà agli utenti di leggere i volumi non visibili. | |
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. |