Wolumin: lista

Przeprowadza wyszukiwanie książki. Wypróbuj

Prośba

Żądanie HTTP

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

Parametry

Nazwa parametru Wartość Opis
Wymagane parametry
q string Pełnotekstowy ciąg zapytania wyszukiwania.
Parametry opcjonalne
download string Ogranicz do woluminów według dostępności pobierania.

Akceptowane wartości to:
  • „epub” – wszystkie woluminy z plikiem EPUB.
filter string Filtrowanie wyników wyszukiwania.

Akceptowane wartości to:
  • „ebooks” – wszystkie e-booki Google.
  • „free-ebooks” – e-book Google z widocznością tekstu w całości.
  • „full” – publicznie może być wyświetlany cały tekst tomu.
  • „paid-ebooks” – e-book Google z ceną.
  • „partial” – tekst jest publicznie dostępny.
langRestrict string Ogranicz wyniki do książek z tym kodem języka.
libraryRestrict string Ogranicz wyszukiwanie do biblioteki tego użytkownika.

Akceptowane wartości to:
  • „my-library” – ograniczenie do biblioteki użytkownika lub dowolnej półki.
  • „no-restrict” – nie ograniczaj na podstawie biblioteki użytkownika.
maxResults unsigned integer Maksymalna liczba wyników do zwrócenia. Akceptowane wartości to od 0 do 40 włącznie.
orderBy string Sortuj wyniki wyszukiwania.

Akceptowane wartości to:
  • „newest” – ostatni.
  • „relevance” – trafność w stosunku do wyszukiwanych słów.
partner string Ograniczaj i oznaczaj wyniki marki na podstawie identyfikatora partnera.
printType string Ogranicz do książek lub czasopism.

Akceptowane wartości to:
  • „all” – wszystkie typy treści woluminów.
  • „books” – tylko książki.
  • „magazines” – tylko czasopisma.
projection string Ogranicz informacje zwracane do zbioru wybranych pól.

Akceptowane wartości to:
  • „full” – zawiera wszystkie dane dotyczące woluminów.
  • „lite” – zawiera podzbiór pól w atrybutachVolumeInfo i accessInfo.
showPreorders boolean Ustaw wartość Prawda, aby wyświetlić książki dostępne w przedsprzedaży. Wartość domyślna to fałsz.
source string Ciąg tekstowy identyfikujący źródło tego żądania.
startIndex unsigned integer Indeks pierwszego wyniku do zwrócenia (zaczyna się od 0)

Treść żądania

Nie podawaj treści żądania przy użyciu tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
Nazwa właściwości Wartość Opis Notatki
kind string Typ zasobu.
items[] list Lista tomów.
totalItems integer Łączna liczba znalezionych tomów. Może być większa niż liczba woluminów zwróconych w tej odpowiedzi, jeśli wyniki zostały podzielone na strony.

Wypróbuj

Użyj eksploratora poniżej, aby wywołać tę metodę w przypadku bieżących danych i wyświetlić odpowiedź.