Wolumin: lista

Umożliwia wyszukiwanie książek. Wypróbuj teraz

Żądanie

Żądanie HTTP

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

Parametry

Nazwa parametru Wartość Opis
Wymagane parametry
q string Ciąg zapytania z pełnym tekstem.
Parametry opcjonalne
download string Ogranicz do woluminów według dostępności pobierania.

Akceptowane wartości:
  • „epub” – wszystkie woluminy z epub.
filter string Filtruj wyniki wyszukiwania.

Akceptowane wartości:
  • „ebooks” – wszystkie e-booki Google.
  • „free-ebooks” – e-book Google z widoczną ilością tekstu.
  • „full” – publicznie może wyświetlać cały tekst woluminu.
  • „paid-ebooks” – e-book Google w cenie.
  • „partial” – publicznie wyświetla część tekstu.
langRestrict string Ogranicz wyniki do książek z tym kodem języka.
libraryRestrict string Ogranicz wyszukiwanie do biblioteki tego użytkownika.

Akceptowane wartości:
  • „my-library” – ogranicza się do biblioteki użytkownika na dowolnej półce.
  • „no-restrict” – nie ograniczaj dostępu do biblioteki użytkownika.
maxResults unsigned integer Maksymalna liczba wyników do zwrócenia. Akceptowane wartości to 0–40 (włącznie).
orderBy string Sortuj wyniki wyszukiwania.

Akceptowane wartości:
  • „newest” – ostatnio opublikowany.
  • „relevance” – trafność względem wyszukiwanych słów.
partner string Ogranicz i zaprezentuj wyniki marki dla identyfikatora partnera.
printType string Ogranicz do książek lub czasopism.

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

Akceptowane wartości:
  • „full” – obejmuje wszystkie dane woluminu.
  • „lite” – zawiera podzbiór pól w plikach volumeInfo i accessInfo.
showPreorders boolean Ustaw wartość true, aby wyświetlać książki dostępne w przedsprzedaży. Wartość domyślna to fałsz.
source string Ciąg identyfikujący autora żądania.
startIndex unsigned integer Indeks pierwszego wyniku do zwrócenia (od 0)

Treść żądania

Nie udostępniaj treści żądania tą metodą.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w następującym formacie:

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

Spróbuj!

Użyj poniższego eksploratora, aby wywołać tę metodę w aktywnych danych i zobaczyć odpowiedź.