Wolumin: lista

Przeprowadza wyszukiwanie książki. Wypróbuj

Żądanie

Żądanie HTTP

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

Parametry

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

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

Akceptowane wartości:
  • „ebooks” – wszystkie e-booki Google.
  • „free-ebooks” – e-book Google z widocznością tekstu w całości.
  • „full” – użytkownicy mogą wyświetlać cały tekst.
  • „paid-ebooks” – e-book Google z ceną.
  • „partial” – część tekstu jest widoczna dla wszystkich.
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” – ograniczenie do biblioteki użytkownika, dowolnej półki.
  • „no-restrict” – nie ograniczaj dostępu 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” – ostatnio opublikowane.
  • „relevance” – trafność w stosunku do wyszukiwanych haseł.
partner string Ograniczanie i oznaczanie wyników za pomocą identyfikatora partnera.
printType string Ogranicz dostęp do książek lub czasopism.

Akceptowane wartości:
  • „all” – wszystkie typy treści objętościowych.
  • „books” – tylko książki.
  • „magazines” – tylko czasopisma.
projection string Ograniczenie zwracania informacji do zbioru wybranych pól.

Akceptowane wartości:
  • „full” – obejmuje wszystkie dane o wolumenie.
  • „lite” – zawiera podzbiór pól w polachVolumeInfo i accessInfo.
showPreorders boolean Ustaw na Prawda, aby wyświetlać książki dostępne do zamówienia 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 (rozpoczyna się od 0)

Treść żądania

W przypadku tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się powiedzie, metoda zwróci odpowiedź o tej strukturze:

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

Wypróbuj

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