Volume

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.list
books.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)
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.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.
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).
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.pdf object Informazioni sui contenuti PDF. (in 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.
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).
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.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.