Volume

Una raccolta Volume viene utilizzata per eseguire una ricerca o elencare i contenuti di una sezione. 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.bookshelves.volumes.list

get
Recupero di una risorsa Volume in base all'ID.
list
Esegue una ricerca di libri.

Rappresentazioni delle risorse

Un volume rappresenta le informazioni su un libro o una rivista ospitate da Google Libri. Contiene metadati, come titolo e autore, nonché dati personalizzati, ad esempio se è stato acquistato o meno. I campi Volume disponibili nella proiezione LITE sono indicati 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. (Nella proiezione LITE).
id string Identificatore univoco di un volume. (Nella proiezione LITE).
etag string Identificatore opaco per una versione specifica di una risorsa volume. (In proiezione LITE)
volumeInfo object Informazioni generali sul volume.
volumeInfo.title string Titolo del volume. (Nella proiezione LITE).
volumeInfo.subtitle string Sottotitolo del volume. (Nella proiezione LITE).
volumeInfo.authors[] list I nomi degli autori e/o degli editor di questo volume. (In proiezione LITE)
volumeInfo.publisher string Editore di questo volume. (Nella proiezione LITE).
volumeInfo.publishedDate string Data di pubblicazione. (Nella proiezione LITE).
volumeInfo.description string Una sinossi del volume. Il testo della descrizione è formattato in 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 volume specifico per settore.
volumeInfo.pageCount integer Numero totale di pagine.
volumeInfo.dimensions object Dimensioni fisiche di questo volume.
volumeInfo.dimensions.height string Altezza o lunghezza del 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, ad esempio "Narrativa", "Thriller" 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). (In proiezione LITE)
volumeInfo.imageLinks.thumbnail string Link all'immagine per le dimensioni delle miniature (larghezza di circa 128 pixel). (in proiezione LITE)
volumeInfo.imageLinks.small string Link all'immagine di piccole dimensioni (larghezza di circa 300 pixel). (in proiezione LITE)
volumeInfo.imageLinks.medium string Link all'immagine di dimensioni medie (larghezza di circa 575 pixel). (in proiezione LITE)
volumeInfo.imageLinks.large string Link all'immagine di grandi dimensioni (larghezza di circa 800 pixel). (in proiezione LITE)
volumeInfo.imageLinks.smallThumbnail string Link all'immagine per miniature di piccole dimensioni (larghezza di circa 80 pixel). (in proiezione LITE)
volumeInfo.imageLinks.extraLarge string Link all'immagine per dimensioni extra large (larghezza di circa 1280 pixel). (in proiezione LITE)
volumeInfo.language string La 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 delle categorie restituito di seguito con il peso più alto.
userInfo object Informazioni specifiche dell'utente relative a questo volume. (ad es. la pagina che ha letto per ultima o se ha acquistato il libro)
userInfo.review nested object La recensione di questo utente del volume, se esistente.
userInfo.readingPosition readingPosition Resource La posizione di lettura corrente dell'utente nel volume, se disponibile. (Nella proiezione LITE).
userInfo.isPurchased boolean Indica se questo volume è stato acquistato o meno dall'utente autenticato che effettua la richiesta. (Nella proiezione LITE).
saleInfo object Eventuali informazioni su un volume relative all'e-bookstore e/o alla possibilità di acquisto. Queste informazioni possono dipendere dal paese da cui proviene la 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 cui sono valide queste informazioni sulla vendita. (Nella proiezione LITE).
saleInfo.saleability string Indica se il libro è disponibile per la vendita o 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 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. (Nella proiezione LITE).
saleInfo.listPrice.currencyCode string Un codice valuta ISO 4217 di tre lettere. (Nella proiezione LITE).
saleInfo.retailPrice object Il prezzo di vendita effettivo del libro. Corrisponde al prezzo di vendita consigliato o al prezzo di listino, a meno che non siano presenti offerte o sconti su questo volume. (in proiezione LITE)
saleInfo.retailPrice.amount double Importo nella valuta indicata di seguito. (Nella proiezione LITE).
saleInfo.retailPrice.currencyCode string Un codice valuta ISO 4217 di tre lettere. (Nella proiezione LITE).
accessInfo object Qualsiasi informazione su un volume relativa alla lettura o all'ottenimento del testo del volume. Queste informazioni possono dipendere dal paese (ad esempio, i libri possono essere di dominio pubblico in un paese, ma non in un altro).
accessInfo.country string Il codice paese ISO_3166-1 di due lettere per cui sono valide queste informazioni di accesso. (Nella proiezione LITE).
accessInfo.viewability string L'accesso in lettura di un volume. I valori possibili sono PARTIAL, ALL_PAGES, NO_PAGES o UNKNOWN. Questo valore dipende dal paese elencato sopra. Un valore PARTIAL indica che il publisher ha consentito la visualizzazione pubblica di una parte del volume senza acquisto. Questo può valere sia per gli ebook che per i libri non digitali. I libri di dominio pubblico avranno sempre un valore ALL_PAGES.
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. (Nella proiezione 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 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 del volume o la scrittura di una recensione. (formato data e ora UTC RFC 3339).
userInfo.isPreordered boolean Indica se questo volume è stato prenotato o meno dall'utente autenticato che effettua la richiesta. (Nella proiezione LITE).
saleInfo.onSaleDate datetime La data in cui il libro è disponibile per la vendita.
accessInfo.textToSpeechPermission string Indica se la funzionalità di sintesi vocale è consentita per questo volume. I valori possono essere ALLOWED, ALLOWED_FOR_ACCESSIBILITY o NOT_ALLOWED.
accessInfo.epub.isAvailable boolean Si tratta di un file epub con testo scorrevole disponibile come dominio pubblico o acquistabile. (Nella proiezione LITE).
accessInfo.pdf.isAvailable boolean È un PDF di un'immagine scansionata disponibile come dominio pubblico o acquistabile. (Nella proiezione LITE).
accessInfo.downloadAccess nested object Informazioni sulle limitazioni di accesso alla licenza di 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 al download.
accessInfo.downloadAccess.deviceAllowed boolean Se limitato, indica se l'accesso è concesso per questo elemento (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 dei contenuti per questo volume.
accessInfo.downloadAccess.downloadsAcquired integer Se limitato, il numero di licenze per il download di contenuti già acquisite (incluso il client richiedente, se in possesso di licenza).
accessInfo.downloadAccess.nonce string Nonce del client per la verifica. Solo accesso al download e convalida del client.
accessInfo.downloadAccess.source string Identificatore dell'app client per la verifica. Solo accesso al download e convalida del client.
accessInfo.downloadAccess.reasonCode string Codice del motivo dell'errore/dell'avviso. In futuro potrebbero essere aggiunti altri codici. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
accessInfo.downloadAccess.message string Messaggio di errore/avviso.
accessInfo.downloadAccess.signature string Firma della risposta.
searchInfo object Informazioni sui risultati di ricerca relativi a questo volume.
searchInfo.textSnippet string Uno snippet di testo contenente la query di ricerca.