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.listbooks.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) | |
selfLink |
string |
Adres URL tego zasobu. (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 |
object |
Lista linków do zdjęć wszystkich dostępnych rozmiarów. (w projekcji 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ę. | |
volumeInfo.previewLink |
string |
URL podglądu tomu w witrynie Książek Google. | |
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). | |
saleInfo.buyLink |
string |
Adres URL, pod którym można kupić tom w witrynie Książek Google. (w projekcji 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.epub.downloadLink |
string |
URL pobierania pliku Epub. (Projekcja LITE). | |
accessInfo.epub.acsTokenLink |
string |
URL pobierania tokena ACS do pobrania epub. (Projekcja LITE). | |
accessInfo.pdf |
object |
Informacje o treściach PDF. (w projekcji LITE) | |
accessInfo.pdf.downloadLink |
string |
URL pobierania pliku pdf. (Projekcja LITE). | |
accessInfo.pdf.acsTokenLink |
string |
URL pobierania tokena ACS do pobrania w formacie PDF. (Projekcja 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ą. | |
|
string |
URL umożliwiający wyświetlenie informacji o tym tomie w witrynie Książek Google. (Projekcja LITE) | |
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). | |
volumeInfo.canonicalVolumeLink |
string |
Kanoniczny adres URL woluminu. (Projekcja LITE). | |
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.webReaderLink |
string |
URL do przeczytania tego tomu w witrynie Książek Google. Link nie umożliwia użytkownikom odczytywania niewidocznych woluminów. | |
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. |