Głośność

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

Metody

Podane niżej metody dotyczą publicznych danych o woluminach i nie wymagają uwierzytelniania.
books.volumes.list
books.volumes.get

Podana niżej metoda dotyczy prywatnego widoku „Moja biblioteka” i wymaga uwierzytelnienia.
books.mylibrary.bookshelves.volumes.list

get
Pobiera zasób Volume na podstawie identyfikatora.
list
Wyszukuje książki.

Prezentacja zasobów

Tom to informacje o książce lub czasopiśmie hostowane przez Książki Google. Zawiera metadane, takie jak tytuł i autor, a także dane spersonalizowane, np. informacje o tym, czy produkt został kupiony. (poniżej podajemy pola dotyczące wolumenu, które są dostępne w projekcji 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
  }
}
Nazwa właściwości Wartość Opis Uwagi
kind string Typ zasobu dla woluminu. (W projekcji LITE)
id string Unikalny identyfikator woluminu. (W projekcji LITE)
etag string Nieczytelny identyfikator konkretnej wersji zasobu objętości. (W projekcji LITE)
volumeInfo object Ogólne informacje o liczbie.
volumeInfo.title string Tytuł tomu. (W projekcji LITE)
volumeInfo.subtitle string Podtytuł głośności. (W projekcji LITE)
volumeInfo.authors[] list Nazwy autorów lub redaktorów danego tomu. (W projekcji LITE)
volumeInfo.publisher string Wydawca tego tomu. (W projekcji LITE)
volumeInfo.publishedDate string Data publikacji. (W projekcji LITE)
volumeInfo.description string streszczenie tomu; Tekst opisu jest sformatowany w HTML i zawiera proste elementy formatowania, takie jak tagi b, i i br. (w projekcji LITE)
volumeInfo.industryIdentifiers[] list Identyfikatory standardu branżowego dla tego woluminu.
volumeInfo.industryIdentifiers[].type string Typ identyfikatora. Możliwe wartości to ISBN_10, ISBN_13, ISSN i OTHER.
volumeInfo.industryIdentifiers[].identifier string Identyfikator woluminu właściwy dla danej branży.
volumeInfo.pageCount integer Łączna liczba stron.
volumeInfo.dimensions object Wymiary fizyczne tego woluminu.
volumeInfo.dimensions.height string Wysokość lub długość tego tomu (w cm).
volumeInfo.dimensions.width string Szerokość tego tomu (w cm).
volumeInfo.dimensions.thickness string Grubość tego woluminu (w cm).
volumeInfo.printType string Typ publikacji tego tomu. Możliwe wartości to KSIĄŻKA lub MAGAZYN.
volumeInfo.categories[] list lista kategorii tematów, takich jak „Fikcyjny”, „Suspense” itp.
volumeInfo.averageRating double Średnia ocena w opiniach dotyczących tego woluminu. (min.1,0, maks.5,0)
volumeInfo.ratingsCount integer Liczba ocen tego woluminu.
volumeInfo.contentVersion string Identyfikator wersji treści woluminu (tekst i obrazy). (W projekcji LITE)
volumeInfo.imageLinks.thumbnail string Link do obrazu w rozmiarze miniatury (szerokość około 128 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.small string Link do obrazu w małym rozmiarze (szerokość około 300 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.medium string Link do obrazu o średnim rozmiarze (szerokość około 575 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.large string Link do obrazu w dużym rozmiarze (szerokość około 800 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.smallThumbnail string Link do obrazu w formie małej miniatury (szerokość około 80 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.extraLarge string Link do obrazu w rozmiarze extra large (szerokość około 1280 pikseli). (w projekcji LITE)
volumeInfo.language string Najlepszy język dla tego tomu (na podstawie treści). Jest to dwuliterowy kod ISO 639-1, np. „fr”, „en” itd.
volumeInfo.mainCategory string Główna kategoria, do której należy ten wolumin. Będzie to kategoria z listy kategorii zwróconych poniżej, która ma najwyższą wagę.
userInfo object Informacje o użytkowniku związane z tym wolumenem. (np. ostatnio przeczytana strona lub informacja, czy użytkownik kupił tę książkę)
userInfo.review nested object opinia tego użytkownika na temat tego tomu (jeśli istnieje).
userInfo.readingPosition readingPosition Resource bieżącą pozycję czytania użytkownika w książce, jeśli jest dostępna; (W projekcji LITE)
userInfo.isPurchased boolean Określa, czy ta ilość została zakupiona przez uwierzytelnionego użytkownika wysyłającego żądanie. (W projekcji LITE)
saleInfo object wszelkie informacje o woluminach związane ze sklepem z e-bookami lub możliwością zakupu; Te informacje mogą zależeć od kraju, z którego pochodzi prośba (np. książki mogą nie być dostępne w określonych krajach).
saleInfo.country string Dwuliterowy kod kraju zgodny ze standardem ISO_3166-1, dla którego te informacje o sprzedaży są ważne. (W projekcji LITE)
saleInfo.saleability string czy książka jest dostępna w sprzedaży czy jest oferowana bezpłatnie w Książkarni Google w wymienionym powyżej kraju. Możliwe wartości to FOR_SALE, FREE, NOT_FOR_SALE lub FOR_PREORDER.
saleInfo.isEbook boolean Czy to jest e-book (czy 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 wymienionej poniżej. (W projekcji LITE)
saleInfo.listPrice.currencyCode string Trzyliterowy kod waluty w formacie ISO 4217. (W projekcji LITE)
saleInfo.retailPrice object Rzeczywista cena sprzedaży książki. Jest to ta sama cena, co sugerowana cena detaliczna lub cena katalogowa, chyba że w przypadku tej ilości dostępne są oferty lub rabaty. (w projekcji LITE)
saleInfo.retailPrice.amount double Kwota w walucie wymienionej poniżej. (W projekcji LITE)
saleInfo.retailPrice.currencyCode string Trzyliterowy kod waluty w formacie ISO 4217. (W projekcji LITE)
accessInfo object wszelkie informacje o tomach związane z czytaniem lub uzyskaniem tekstu tomu; Te informacje mogą zależeć od kraju (np. książki mogą być w domeny publicznej w jednym kraju, ale nie w innym).
accessInfo.country string Dwuliterowy kod kraju zgodny ze standardem ISO_3166-1, dla którego te informacje o dostępie są ważne. (W projekcji LITE)
accessInfo.viewability string Dostęp do odczytu woluminu. Możliwe wartości to PARTIAL, ALL_PAGES, NO_PAGES lub UNKNOWN. Ta wartość zależy od kraju wymienionego powyżej. Wartość PARTIAL oznacza, że wydawca zezwolił na publiczne wyświetlanie części zasobów bez konieczności ich zakupu. Dotyczy to zarówno e-booków, jak i innych treści. Książki w domenie publicznej zawsze mają wartość ALL_PAGES.
accessInfo.epub object informacje o treściach w formacie epub; (w projekcji LITE)
accessInfo.pdf object informacje o treściach w pliku PDF; (w projekcji LITE)
accessInfo.accessViewStatus string Łączy dostęp i widoczność tego wolumenu w jednym polu stanu dla tego użytkownika. Możliwe wartości to FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE lub NONE. (W projekcji LITE)
accessInfo.embeddable boolean Określa, czy ten wolumin można umieścić w widoku za pomocą interfejsu Embedded Viewer API.
accessInfo.publicDomain boolean Czy ta książka należy do domeny publicznej w wymienionym powyżej kraju.
userInfo.updated datetime Sygnatura czasowa ostatniej modyfikacji tego tomu przez użytkownika, np. aktualizacja pozycji czytania, zakup w wielokrotności lub napisanie recenzji. (format daty i czasu UTC RFC 3339).
userInfo.isPreordered boolean Określa, czy ta ilość została wstępnie zamówiona przez uwierzytelnionego użytkownika wysyłającego żądanie. (W projekcji LITE)
saleInfo.onSaleDate datetime Data, od której książka jest dostępna w sprzedaży.
accessInfo.textToSpeechPermission string Czy w przypadku tego woluminu dozwolona jest zamiana tekstu na mowę. Możliwe wartości: ALLOWED, ALLOWED_FOR_ACCESSIBILITY lub NOT_ALLOWED.
accessInfo.epub.isAvailable boolean Czy jest dostępny e-book z tekstem płynącym w wersji bezpłatnej lub płatnej. (W projekcji LITE)
accessInfo.pdf.isAvailable boolean czy zeskanowany obraz jest dostępny w formie pliku PDF w domenie publicznej lub do kupienia. (W projekcji LITE)
accessInfo.downloadAccess nested object Informacje o ograniczeniach dostępu do licencji na pobranie woluminu.
accessInfo.downloadAccess.kind string Typ zasobu.
accessInfo.downloadAccess.volumeId string Określa wolumin, którego dotyczy ten wpis.
accessInfo.downloadAccess.restricted boolean czy ten wolumin ma ograniczenia dostępu do pobierania.
accessInfo.downloadAccess.deviceAllowed boolean Jeśli dostęp jest ograniczony, czy jest on przyznawany w przypadku tego użytkownika, urządzenia lub woluminu.
accessInfo.downloadAccess.justAcquired boolean Jeśli deviceAllowed, czy dostęp został właśnie uzyskany w ramach tego żądania.
accessInfo.downloadAccess.maxDownloadDevices integer W przypadku ograniczeń maksymalna liczba licencji na pobranie treści z tego tomu.
accessInfo.downloadAccess.downloadsAcquired integer W przypadku ograniczeń liczba licencji na pobieranie treści już zakupionych (w tym klienta, który wysłał żądanie, jeśli ma licencję).
accessInfo.downloadAccess.nonce string Niepowtarzalny identyfikator klienta do weryfikacji. Dostęp do pobierania i weryfikacja klienta.
accessInfo.downloadAccess.source string Identyfikator aplikacji klienta do weryfikacji. Dostęp do pobierania i weryfikacja klienta.
accessInfo.downloadAccess.reasonCode string Kod przyczyny błędu/ostrzeżenia. W przyszłości możemy dodać kolejne kody. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
accessInfo.downloadAccess.message string komunikat o błędzie lub ostrzeżeniu.
accessInfo.downloadAccess.signature string Podpis odpowiedzi.
searchInfo object Informacje o wynikach wyszukiwania związanych z tą liczbą wyszukiwań.
searchInfo.textSnippet string Fragment tekstu zawierający zapytanie.