Per eseguire una ricerca o elencare i contenuti di uno scaffale viene usata una raccolta
Volume
. 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 "La mia raccolta" dei volumi e richiede l'autenticazione.
books.mylibrary.bookshbooks.volumes.list
- ricevi
- Recupera una risorsa volume in base all'ID.
- list
- Esegui una ricerca di libri.
Rappresentazioni delle risorse
Un volume rappresenta le informazioni su un libro o su una rivista ospitate da Google Libri. Contiene metadati, come titolo e autore, nonché dati personalizzati, ad esempio se sono stati acquistati o meno. Di seguito sono indicati i campi del volume disponibili nella proiezione LITE.
{ "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 LITE). | |
id |
string |
Identificatore univoco per un volume. (Proiezione LITE). | |
etag |
string |
Identificatore opaco per una versione specifica di una risorsa di volume. (Proiezione LITE) | |
selfLink |
string |
URL a questa risorsa. (Proiezione LITE). | |
volumeInfo |
object |
Informazioni generali sul volume. | |
volumeInfo.title |
string |
Titolo del volume. (Proiezione LITE). | |
volumeInfo.subtitle |
string |
Sottotitolo del volume. (Proiezione LITE). | |
volumeInfo.authors[] |
list |
I nomi degli autori e/o degli editori di questo volume. (Proiezione LITE) | |
volumeInfo.publisher |
string |
Publisher di questo volume. (Proiezione LITE). | |
volumeInfo.publishedDate |
string |
Data di pubblicazione. (Proiezione LITE). | |
volumeInfo.description |
string |
Una sinossi del volume. Il testo della descrizione è in formato HTML e include elementi di formattazione semplici, come i tag b, i e br. (in 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 di volume specifico per settore. | |
volumeInfo.pageCount |
integer |
Numero totale di pagine. | |
volumeInfo.dimensions |
object |
Dimensioni fisiche del volume. | |
volumeInfo.dimensions.height |
string |
Altezza o lunghezza di questo volume (in cm). | |
volumeInfo.dimensions.width |
string |
Larghezza del 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 "Saggistica", "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 |
Identificatore della versione dei contenuti del volume (testo e immagini). (Proiezione LITE) | |
volumeInfo.imageLinks |
object |
Un elenco di link immagine per tutte le dimensioni disponibili. (in proiezione LITE) | |
volumeInfo.imageLinks.thumbnail |
string |
Link dell'immagine per le dimensioni della miniatura (larghezza di ~128 pixel). (in proiezione LITE) | |
volumeInfo.imageLinks.small |
string |
Link immagine per dimensioni ridotte (larghezza di circa 300 pixel). (in proiezione LITE) | |
volumeInfo.imageLinks.medium |
string |
Link immagine per dimensioni medie (larghezza di circa 575 pixel). (in proiezione LITE) | |
volumeInfo.imageLinks.large |
string |
Link immagine per dimensioni grandi (larghezza di ~800 pixel). (in proiezione LITE) | |
volumeInfo.imageLinks.smallThumbnail |
string |
Link dell'immagine per le dimensioni delle miniature piccole (larghezza di circa 80 pixel). (in proiezione LITE) | |
volumeInfo.imageLinks.extraLarge |
string |
Link immagine per dimensioni molto grandi (larghezza di circa 1280 pixel). (in 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 dell'elenco di categorie restituito qui sotto che ha la ponderazione più elevata. | |
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.pagina che l'utente ha letto l'ultima volta o se ha acquistato questo libro). | |
userInfo.review |
nested object |
La recensione di questo volume da parte dell'utente, se esistente. | |
userInfo.readingPosition |
readingPosition Resource |
La posizione di lettura attuale dell'utente nel volume, se disponibile. (Proiezione LITE). | |
userInfo.isPurchased |
boolean |
Indica se questo volume è stato acquistato o meno dall'utente autenticato che ha effettuato la richiesta. (Proiezione LITE). | |
saleInfo |
object |
Qualsiasi informazione su un volume relativo all'ebookstore e/o all'acquisto. Queste informazioni possono dipendere dal paese di origine della richiesta (ad es., 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 le informazioni di vendita sono valide. (Proiezione LITE). | |
saleInfo.saleability |
string |
Consente di indicare se questo libro è disponibile per la vendita o se è offerto senza costi nel Google eBookstore per il paese elencato sopra. I valori possibili sono FOR_SALE, SENZA COSTI, NOT_FOR_SALE o FOR_PREORDER. | |
saleInfo.isEbook |
boolean |
Consente di indicare se questo volume è un ebook (può essere aggiunto alla sezione I miei ebook). | |
saleInfo.listPrice |
object |
Prezzo di vendita suggerito. (in proiezione LITE) | |
saleInfo.listPrice.amount |
double |
Importo nella valuta indicata di seguito. (Proiezione LITE). | |
saleInfo.listPrice.currencyCode |
string |
Un codice valuta ISO 4217 di tre lettere. (Proiezione LITE). | |
saleInfo.retailPrice |
object |
Il prezzo di vendita effettivo del libro. Corrisponde al prezzo di vendita suggerito o al prezzo di listino suggerito, a meno che non ci siano offerte o sconti su questo volume. (in proiezione LITE) | |
saleInfo.retailPrice.amount |
double |
Importo nella valuta indicata di seguito. (Proiezione LITE). | |
saleInfo.retailPrice.currencyCode |
string |
Un codice valuta ISO 4217 di tre lettere. (Proiezione LITE). | |
saleInfo.buyLink |
string |
URL per acquistare questo volume sul sito di Google Libri. (in proiezione LITE) | |
accessInfo |
object |
Qualsiasi informazione su un volume relativo alla lettura o all'ottenimento 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 sono valide queste informazioni di accesso. (Proiezione LITE). | |
accessInfo.viewability |
string |
L'accesso in lettura di un volume. I valori possibili sono PARTIAL, ALL_PAGE, NO_PHOTOS o UNKNOWN. Questo valore dipende dal paese elencato sopra. Un valore di PARTIAL indica che l'editore ha consentito di visualizzare pubblicamente una parte del volume, senza acquisto. Questo vale per gli ebook e non per gli ebook. I libri di dominio pubblico avranno sempre un valore di ALL_PAGE. | |
accessInfo.epub |
object |
Informazioni sui contenuti epub. (in proiezione LITE) | |
accessInfo.epub.downloadLink |
string |
URL per scaricare il file epub. (Proiezione LITE). | |
accessInfo.epub.acsTokenLink |
string |
URL per recuperare il token ACS per il download epub. (Proiezione LITE). | |
accessInfo.pdf |
object |
Informazioni sui contenuti PDF. (in proiezione LITE) | |
accessInfo.pdf.downloadLink |
string |
URL per scaricare il PDF. (Proiezione LITE). | |
accessInfo.pdf.acsTokenLink |
string |
URL per recuperare il token ACS per il download di PDF. (Proiezione LITE). | |
accessInfo.accessViewStatus |
string |
Combina l'accesso e la visibilità di questo volume in un unico campo di stato per questo utente. I valori possono essere FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE o NONE. (Proiezione LITE). | |
accessInfo.embeddable |
boolean |
Indica se questo volume può essere incorporato in un'area visibile utilizzando l'API Embedded Viewers. | |
accessInfo.publicDomain |
boolean |
Indica se questo libro è di dominio pubblico nel paese elencato sopra. | |
|
string |
URL per visualizzare le informazioni su questo volume sul sito di Google Libri. (Proiezione LITE) | |
userInfo.updated |
datetime |
Timestamp della data dell'ultima modifica di questo volume eseguita da un'azione dell'utente, ad esempio un aggiornamento della posizione di lettura, l'acquisto di un volume o la scrittura di una recensione. (Formato data/ora RFC 3339 UTC). | |
volumeInfo.canonicalVolumeLink |
string |
URL canonico di un volume. (Proiezione LITE). | |
userInfo.isPreordered |
boolean |
Indica se questo volume è stato prenotato o meno dall'utente autenticato che ha effettuato la richiesta. (Proiezione LITE). | |
saleInfo.onSaleDate |
datetime |
La data in cui il libro è 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 di testo adattabile disponibile come dominio pubblico o per l'acquisto. (Proiezione LITE). | |
accessInfo.pdf.isAvailable |
boolean |
Il file PDF di un'immagine scansionata è disponibile come dominio pubblico o per l'acquisto. (Proiezione LITE). | |
accessInfo.webReaderLink |
string |
URL per leggere questo volume sul sito di Google Libri. Il link non consentirà agli utenti di leggere volumi non visibili. | |
accessInfo.downloadAccess |
nested object |
Informazioni sulle limitazioni di accesso alle licenze di download di un volume. | |
accessInfo.downloadAccess.kind |
string |
Tipo di risorsa. | |
accessInfo.downloadAccess.volumeId |
string |
Identifica il volume per 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, se l'accesso è consentito per questo utente (utente, dispositivo, volume). | |
accessInfo.downloadAccess.justAcquired |
boolean |
Se deviceAllowed, consente di acquisire l'accesso con questa richiesta. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
Se sono presenti limitazioni, il numero massimo di licenze per il download di contenuti per questo volume. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
Se sono state applicate limitazioni, il numero di licenze di download dei contenuti già acquisite (incluso il cliente richiedente, se con licenza). | |
accessInfo.downloadAccess.nonce |
string |
Il cliente non ha completato la verifica. Accesso solo a download e convalida client. | |
accessInfo.downloadAccess.source |
string |
Identificatore dell'app client per la verifica. Accesso solo a 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_USE_LAST_ACCESS | |
accessInfo.downloadAccess.message |
string |
Messaggio di errore/avviso. | |
accessInfo.downloadAccess.signature |
string |
Firma della risposta. | |
searchInfo |
object |
Informazioni sui risultati di ricerca correlate a questo volume. | |
searchInfo.textSnippet |
string |
Uno snippet di testo contenente la query di ricerca. |