Wolumin

Kolekcja Volume służy do wyszukiwania lub wyświetlania zawartości półki. Ta kolekcja jest tylko do odczytu.

Metody

Poniższe metody odnoszą się do danych publicznych o woluminach i nie wymagają uwierzytelniania.
books.volumes.list
books.volumes.get

Ta metoda ma zastosowanie do prywatnego widoku woluminów „Moja biblioteka” i wymaga uwierzytelniania.
books.mylibrary.bookshelves.volumes.list

pobierz
Pobiera zasób woluminu na podstawie identyfikatora.
list
Wyszukuje książkę.

Reprezentacje zasobów

Tom to informacje o książce lub czasopiśmie przechowywane w Książkach Google. Zawiera metadane, takie jak tytuł i autor, a także spersonalizowane dane o tym, czy zostały one kupione. (pola woluminu dostępne w odwzorowaniu LITE są wymienione poniżej).

{
  "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
  }
}
Nazwa usługi Wartość Opis Uwagi
kind string Typ zasobu woluminu. (Projekcja LITE).
id string Unikalny identyfikator woluminu. (Projekcja LITE).
etag string Nieprzezroczysty identyfikator konkretnej wersji zasobu woluminu. (Projekcja LITE)
volumeInfo object Ogólne informacje o woluminach.
volumeInfo.title string Tytuł woluminu. (Projekcja LITE).
volumeInfo.subtitle string Podtytuł woluminu. (Projekcja LITE).
volumeInfo.authors[] list Nazwy autorów lub edytorów tego tomu. (Projekcja LITE)
volumeInfo.publisher string Wydawca tego tomu. (Projekcja LITE).
volumeInfo.publishedDate string Data publikacji. (Projekcja LITE).
volumeInfo.description string Streszczenie woluminu. Tekst opisu jest sformatowany w języku HTML i zawiera proste elementy formatowania, takie jak tagi b, i i br. (w projekcji LITE)
volumeInfo.industryIdentifiers[] list Identyfikatory branżowe określone dla tego woluminu.
volumeInfo.industryIdentifiers[].type string Typ identyfikatora. Możliwe wartości to ISBN_10, ISBN_13, ISSN i inne.
volumeInfo.industryIdentifiers[].identifier string Identyfikator branży.
volumeInfo.pageCount integer Łączna liczba stron.
volumeInfo.dimensions object Wymiary fizyczne tego woluminu.
volumeInfo.dimensions.height string Wysokość lub długość woluminu (w cm).
volumeInfo.dimensions.width string Szerokość woluminu (w cm).
volumeInfo.dimensions.thickness string Grubość woluminu (w cm).
volumeInfo.printType string Typ publikacji tego tomu. Możliwe wartości: BOOK lub MAGAZINE.
volumeInfo.categories[] list Lista kategorii tematycznych, np. „Fikcja”, „Dreszek” itp.
volumeInfo.averageRating double Średnia ocena dla tego tomu. (min.= 1,0, maks.= 5,0)
volumeInfo.ratingsCount integer Liczba ocen tego tomu.
volumeInfo.contentVersion string Identyfikator wersji treści woluminu (tekstowego i graficznego). (Projekcja LITE)
volumeInfo.imageLinks.thumbnail string Link do zdjęcia o rozmiarze miniatury (szerokość ~128 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.small string Link do zdjęcia o małym rozmiarze (szerokość ok. 300 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.medium string Link do zdjęcia o średniej wielkości (szerokość ~755 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.large string Link do zdjęcia o dużym rozmiarze (szerokość ~800 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.smallThumbnail string Link do obrazu o małej rozmiarze (szerokość ok. 80 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.extraLarge string Link do zdjęcia dotyczący bardzo dużego rozmiaru (szerokość ~1280 pikseli). (w projekcji LITE)
volumeInfo.language string Najlepszy język dla tego woluminu (na podstawie treści). Jest to dwuliterowy kod ISO 639-1, np. „fr”, „en”.
volumeInfo.mainCategory string Główna kategoria, do której należy ten wolumin. Będzie to kategoria z listy kategorii wymienionych poniżej, która będzie miała najwyższą wagę.
userInfo object Informacje o użytkowniku związane z tym woluminem. (np. strona, którą ten użytkownik ostatnio czytał, czy ta książka została kupiona)
userInfo.review nested object Opinia użytkownika o tym woluminie, jeśli taka istnieje.
userInfo.readingPosition readingPosition Resource Obecna pozycja użytkownika w woluminie (jeśli jest dostępna). (Projekcja LITE).
userInfo.isPurchased boolean Określa, czy ten wolumin został kupiony przez uwierzytelnionego użytkownika wysyłającego żądanie. (Projekcja LITE).
saleInfo object Wszelkie informacje o tomach związanych ze sklepem e-book lub o możliwości zakupu. Zależy to od kraju, z którego pochodzi żądanie (np. w niektórych krajach książki mogą nie być sprzedawane).
saleInfo.country string Dwuliterowy kod kraju w standardzie ISO_3166-1, dla którego ważne są dane dotyczące sprzedaży. (Projekcja LITE).
saleInfo.saleability string Ta książka jest dostępna w sprzedaży lub oferowana bezpłatnie w e-booku Google w kraju podanym powyżej. Dostępne wartości to FOR_SALE, free, NOT_FOR_SALE lub FOR_PREORDER.
saleInfo.isEbook boolean Określa, czy to wolumin jest e-bookiem (można go dodać do półki Moje e-booki).
saleInfo.listPrice object Sugerowana cena detaliczna. (w projekcji LITE)
saleInfo.listPrice.amount double Kwota w walucie podanej poniżej. (Projekcja LITE).
saleInfo.listPrice.currencyCode string Trzyliterowy kod waluty w formacie ISO 4217. (Projekcja LITE).
saleInfo.retailPrice object Rzeczywista cena sprzedaży książki. Jest taka sama jak sugerowana cena detaliczna lub rynkowa, chyba że istnieją oferty lub rabaty na to wydanie. (w projekcji LITE)
saleInfo.retailPrice.amount double Kwota w walucie podanej poniżej. (Projekcja LITE).
saleInfo.retailPrice.currencyCode string Trzyliterowy kod waluty w formacie ISO 4217. (Projekcja LITE).
accessInfo object Informacje o wolumenie związane z czytaniem lub pobieraniem tekstu. Te informacje mogą się różnić w zależności od kraju (książki mogą w jednym kraju należeć do domeny publicznej, a w innym nie).
accessInfo.country string Dwuliterowy kod kraju w formacie ISO_3166-1, dla którego ważne są te informacje o dostępie. (Projekcja LITE).
accessInfo.viewability string Uprawnienia do odczytu woluminu. Możliwe wartości to PARTIAL, ALL_PAGES, NO_PAGES lub UNKNOWN. Ta wartość zależy od kraju podanego powyżej. Wartość PARTIAL oznacza, że wydawca zezwolił na wyświetlanie części woluminu bez zakupu. Dotyczy to zarówno e-booków, jak i innych e-booków. Książki należące do domeny publicznej zawsze mają wartość ALL_PAGES.
accessInfo.epub object Informacje o treściach EPUB. (w projekcji LITE)
accessInfo.pdf object Informacje o treściach PDF. (w projekcji LITE)
accessInfo.accessViewStatus string Łączy dostęp oraz widoczność tego woluminu w jednym polu stanu dla tego użytkownika. Dostępne wartości to FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE lub NONE. (Projekcja LITE).
accessInfo.embeddable boolean Określa, czy ten wolumin może być umieszczony w widocznym obszarze za pomocą interfejsu embed Viewer API.
accessInfo.publicDomain boolean Określa, czy w wymienionym powyżej kraju książka jest w Twoim kraju własnością publiczną.
userInfo.updated datetime Sygnatura czasowa ostatniej modyfikacji tego działania przez działanie użytkownika, np. aktualizacja miejsca czytania, zakup woluminu lub napisanie opinii. (format daty i godziny UTC 3339 UTC).
userInfo.isPreordered boolean Określa, czy ten wolumin został zamówiony w przedsprzedaży przez uwierzytelnionego użytkownika wysyłającego żądanie. (Projekcja LITE).
saleInfo.onSaleDate datetime Dzień, w którym książka jest dostępna w sprzedaży.
accessInfo.textToSpeechPermission string Określa, czy zamiana tekstu na mowę jest dozwolona w przypadku tego woluminu. Możliwe wartości: ALLOWED, ALLOWED_FOR_ACCESSIBILITY lub NOT_ALLOWED.
accessInfo.epub.isAvailable boolean Czy e-pub (tekst ciągły) jest dostępny w ramach domeny publicznej lub do kupienia. (Projekcja LITE).
accessInfo.pdf.isAvailable boolean Czy zeskanowany obraz pdf jest dostępny w domenie publicznej lub do kupienia. (Projekcja LITE).
accessInfo.downloadAccess nested object Informacje o ograniczeniach dostępu do licencji na pobieranie woluminu.
accessInfo.downloadAccess.kind string Typ zasobu.
accessInfo.downloadAccess.volumeId string Określa wolumin, którego dotyczy ten wpis.
accessInfo.downloadAccess.restricted boolean Określa, czy wolumin ma ograniczenia dotyczące pobierania.
accessInfo.downloadAccess.deviceAllowed boolean Czy dostęp jest ograniczony (czy użytkownik, urządzenie, głośność).
accessInfo.downloadAccess.justAcquired boolean Jeśli pole Zezwalaj na dostęp do urządzenia, czy dostęp został właśnie uzyskany przy użyciu tego żądania.
accessInfo.downloadAccess.maxDownloadDevices integer Maksymalna liczba licencji na pobieranie treści w przypadku tego woluminu (jeśli jest ograniczona).
accessInfo.downloadAccess.downloadsAcquired integer Liczba licencji z pobraniem treści (wraz z klientem, jeśli ma licencję), jeśli jest ograniczona, jest ograniczona.
accessInfo.downloadAccess.nonce string Identyfikator jednorazowego klienta do weryfikacji. Dostęp tylko do pobierania i weryfikacji klienta.
accessInfo.downloadAccess.source string Identyfikator aplikacji klienta do weryfikacji. Dostęp tylko do pobierania i weryfikacji klienta.
accessInfo.downloadAccess.reasonCode string Kod błędu/ostrzeżenia. W przyszłości możemy dodać więcej kodów. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
accessInfo.downloadAccess.message string Błąd/ostrzeżenie.
accessInfo.downloadAccess.signature string Podpis odpowiedzi.
searchInfo object Informacje o wynikach wyszukiwania związane z tym tomem.
searchInfo.textSnippet string Fragment tekstu zawierający wyszukiwane hasło.