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

Poniższe metody mają zastosowanie do publicznych danych o woluminach i nie wymagają uwierzytelniania.
books.volumes.list
books.volumes.get

Ta metoda dotyczy prywatnego widoku woluminów „Moja biblioteka” i wymaga uwierzytelnienia.
books.mylibrary.bookshelves.volumes.list

pobierz
Pobiera zasób woluminu na podstawie identyfikatora.
list
Przeprowadza wyszukiwanie książki.

Reprezentacje zasobów

Tom przedstawia 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 Notatki
kind string Typ zasobu woluminu. (W projekcji LITE).
id string Unikalny identyfikator woluminu. (W projekcji LITE).
etag string Nieprzezroczysty identyfikator konkretnej wersji zasobu woluminu. (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 Imiona i nazwiska autorów lub redaktorów tego 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 języku HTML i zawiera proste elementy formatowania, takie jak tagi b, i oraz 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 oraz OTHER.
volumeInfo.industryIdentifiers[].identifier string Identyfikator wolumenu w danej branży.
volumeInfo.pageCount integer Łączna liczba stron.
volumeInfo.dimensions object Fizyczne wymiary tej woluminu.
volumeInfo.dimensions.height string Wysokość lub długość tej objętości (w cm).
volumeInfo.dimensions.width string Szerokość tego objętości (w cm).
volumeInfo.dimensions.thickness string Grubość tej objętości (w cm).
volumeInfo.printType string Typ publikacji tego tomu. Możliwe wartości to BOOK lub MAGAZINE.
volumeInfo.categories[] list listę kategorii tematycznych, takich jak „Fikcja”, „Dreszczowce” itp.;
volumeInfo.averageRating double Średnia ocena tego tomu. (min = 1,0, maks = 5,0)
volumeInfo.ratingsCount integer Liczba ocen w opiniach tego tomu.
volumeInfo.contentVersion string Identyfikator wersji treści woluminu (tekstu i obrazów). (W projekcji LITE)
volumeInfo.imageLinks.thumbnail string Link do zdjęcia dla rozmiaru miniatury (szerokość ok. 128 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.small string Link do zdjęcia w małym rozmiarze (szerokość ok. 300 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.medium string Link do zdjęcia o średnim rozmiarze (szerokość ok. 575 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.large string Link do zdjęcia w dużym rozmiarze (szerokość ok. 800 pikseli). (w projekcji LITE)
volumeInfo.imageLinks.smallThumbnail string Link do zdjęcia dla małej miniatury (szerokość ok. 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 do 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 wyświetlonej poniżej listy kategorii, która ma najwyższą wagę.
userInfo object Informacje dotyczące konkretnego użytkownika dotyczące tego woluminu. (np. strona ostatnio czytana przez użytkownika lub informacje o tym, czy kupił tę książkę)
userInfo.review nested object Recenzja tego woluminu (jeśli istnieje).
userInfo.readingPosition readingPosition Resource Obecna pozycja czytania użytkownika w woluminie (jeśli jest dostępna). (W projekcji LITE).
userInfo.isPurchased boolean Wskazuje, czy ten wolumin został kupiony przez uwierzytelnionego użytkownika wysyłającego żądanie. (W projekcji LITE).
saleInfo object Wszelkie informacje o tomach związanych z sklepem e-booków lub możliwością zakupu. Te informacje mogą zależeć od kraju, z którego pochodzi zgłoszenie (np. książki mogą nie być sprzedawane w niektórych krajach).
saleInfo.country string Dwuliterowy kod kraju ISO_3166-1, którego dotyczą te informacje o sprzedaży. (W projekcji LITE).
saleInfo.saleability string Określa, czy książka jest dostępna w sprzedaży lub oferowana bezpłatnie w sklepie Google e-Bookstore w wymienionych powyżej krajach. Możliwe wartości to FOR_SALE, FREE, NOT_FOR_SALE oraz FOR_PREORDER.
saleInfo.isEbook boolean Określa, czy ten wolumin jest e-bookiem (można dodać go 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. (W projekcji LITE).
saleInfo.listPrice.currencyCode string Trzyliterowy kod waluty w standardzie ISO 4217. (W projekcji LITE).
saleInfo.retailPrice object Rzeczywista cena sprzedaży książki. Jest taka sama jak sugerowana cena detaliczna lub rynkowa cena detaliczna, chyba że w przypadku tego zbioru są dostępne oferty lub rabaty. (w projekcji LITE)
saleInfo.retailPrice.amount double Kwota w walucie podanej poniżej. (W projekcji LITE).
saleInfo.retailPrice.currencyCode string Trzyliterowy kod waluty w standardzie 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 ISO_3166-1, którego dotyczą te informacje o dostępie. (W projekcji LITE).
accessInfo.viewability string Uprawnienia do odczytu woluminu. Możliwe wartości to PARTIAL, ALL_PAGES, NO_PAGES i 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 należące do domeny publicznej mają zawsze wartość ALL_PAGES.
accessInfo.epub object Informacje o treściach EPUB. (w projekcji LITE)
accessInfo.pdf object Informacje o zawartości pliku PDF. (w projekcji LITE)
accessInfo.accessViewStatus string Łączy dostęp i widoczność tego woluminu w jedno pole stanu dla tego użytkownika. 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 Wyświetlający API.
accessInfo.publicDomain boolean Wskazuje, czy 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 Wskazuje, czy ten wolumin został zamówiony w przedsprzedaży 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 Określa, czy zamiana tekstu na mowę jest dozwolona w przypadku tej głośności. Wartości to 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 Zeskanowany obraz w formacie PDF jest dostępny w domenie publicznej lub w sprzedaży. (W projekcji 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 Identyfikuje wolumin, do którego ma zastosowanie dany wpis.
accessInfo.downloadAccess.restricted boolean Określa, czy ten wolumin ma jakiekolwiek 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, określa, czy dostęp został właśnie uzyskany za pomocą tego żądania.
accessInfo.downloadAccess.maxDownloadDevices integer Maksymalna liczba licencji na pobieranie treści, jeśli są ograniczone, w przypadku tego woluminu.
accessInfo.downloadAccess.downloadsAcquired integer Jeśli są ograniczone, liczba już pozyskanych licencji na pobieranie treści (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 klienckiej na potrzeby 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ć więcej kodów. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
accessInfo.downloadAccess.message string Komunikat o błędzie/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.