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 "La mia raccolta" dei volumi 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. (In proiezione LITE).
id string Identificatore univoco per un volume. (proiezione in LITE).
etag string Identificatore opaco per una versione specifica di una risorsa di volume. (In proiezione LITE)
volumeInfo object Informazioni generali sul volume.
volumeInfo.title string Titolo del volume. (In proiezione LITE).
volumeInfo.subtitle string Sottotitolo del volume. (proiezione in LITE).
volumeInfo.authors[] list I nomi degli autori e/o degli editor 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 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, 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). (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 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). (in 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 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. (proiezione in LITE).
userInfo.isPurchased boolean Indica se questo volume è stato acquistato o meno dall'utente autenticato che effettua la richiesta. (In 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. (In 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 allo scaffale I miei eBook).
saleInfo.listPrice object Prezzo di vendita suggerito. (in proiezione LITE)
saleInfo.listPrice.amount double Importo nella valuta indicata di seguito. (In proiezione 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. (In proiezione LITE).
saleInfo.retailPrice.currencyCode string Un codice valuta ISO 4217 di tre lettere. (In proiezione LITE).
accessInfo object Qualsiasi informazione su un volume correlata alla lettura o al recupero del testo del volume in questione. 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_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 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. (In 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. (In proiezione 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 Si tratta di un file epub con testo scorrevole disponibile come dominio pubblico o acquistabile. (In proiezione LITE).
accessInfo.pdf.isAvailable boolean È un PDF di un'immagine scansionata disponibile come dominio pubblico o acquistabile. (In 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 per il 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 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.