Wolumin

Kolekcja Volume służy do wyszukiwania zawartości półki lub wyświetlania jej zawartości. Ta kolekcja jest dostępna 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 uwierzytelniania.
books.mylibrary.bookshelves.volumes.list

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

Prezentacja zasobów

Tom reprezentuje informacje o książce lub czasopiśmie przechowywane w Książkach Google. Zawiera metadane, takie jak tytuł i autor, a także spersonalizowane dane, np. o tym, czy film został kupiony. (Pola woluminu dostępne w prognozowaniu LITE zostały opisane 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 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 głośności.
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 woluminu. Tekst opisu jest sformatowany w HTML i zawiera proste elementy formatowania, takie jak tagi b, i i br. (w projekcji LITE)
volumeInfo.industryIdentifiers[] list Standardowe identyfikatory branżowe dla tej ilości.
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ść tej objętości (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 zdjęcia w bardzo dużym rozmiarze (szerokość ok. 1280 pikseli). (w projekcji LITE)
volumeInfo.language string Najlepszy język dla tego wolumenu (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 powią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ę 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 książkami elektronicznymi 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 oraz 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 tomie związane z odczytaniem lub uzyskaniem jego tekstu. Te informacje mogą się różnić w zależności od kraju (np. w jednym kraju książki mogą należeć do domeny publicznej, a w innym nie).
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 pewnej części tomu bez konieczności zakupu. Dotyczy to zarówno e-booków, jak i innych książek. 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 wolumin można umieścić w widocznym obszarze 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 woluminu przez działanie użytkownika, np. zaktualizowanie pozycji czytania, zakup tomu lub napisanie opinii. (w formacie RFC 3339 UTC, data i godzina).
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 Dzień, w którym książka pojawi się 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 plik EPUB z tekstem ciągłym jest dostępny w ramach domeny publicznej lub do kupienia. (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, określa, czy jest przyznawany dostęp do tego elementu (użytkownika, urządzenia, 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 Liczba jednorazowa 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ązane z tym tomem.
searchInfo.textSnippet string Fragment tekstu zawierający zapytanie.