Эта страница переведена с помощью Cloud Translation API.

Объем: список

Выполняет поиск книги. Попробуйте прямо сейчас .

Запрос

HTTP-запрос

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

Параметры

Имя параметра	Ценность	Описание
Требуемые параметры
`q`	`string`	Строка запроса полнотекстового поиска.
Дополнительные параметры
`download`	`string`	Ограничение объемов по доступности загрузки. Допустимые значения: " `epub` " - Все тома с epub.
`filter`	`string`	Фильтровать результаты поиска. Допустимые значения: " `ebooks` " – все электронные книги Google. " `free-ebooks` " - электронная книга Google с возможностью просмотра полного объема текста. " `full` " - публика может просматривать весь текст тома. " `paid-ebooks` " - электронная книга Google с указанием цены. " `partial` " - Публика может видеть части текста.
`langRestrict`	`string`	Ограничить результаты книгами с этим языковым кодом.
`libraryRestrict`	`string`	Ограничить поиск библиотекой этого пользователя. Допустимые значения: " `my-library` " - Ограничить библиотекой пользователя, любой полкой. « `no-restrict` » — не ограничивать на основе пользовательской библиотеки.
`maxResults`	`unsigned integer`	Максимальное количество возвращаемых результатов. Допустимые значения: от `0` до `40` включительно.
`orderBy`	`string`	Сортировать результаты поиска. Допустимые значения: « `newest` » — самый последний из опубликованных. « `relevance` » — релевантность поисковым запросам.
`partner`	`string`	Ограничение и брендирование результатов для идентификатора партнера.
`printType`	`string`	Ограничьтесь книгами или журналами. Допустимые значения: « `all` » — все типы содержимого тома. " `books` " - Просто книги. " `magazines` " - Просто журналы.
`projection`	`string`	Ограничьте возвращаемую информацию набором выбранных полей. Допустимые значения: « `full` » — включает все данные тома. « `lite` » — включает подмножество полей в volumeInfo и accessInfo.
`showPreorders`	`boolean`	Установите значение true, чтобы показывать книги, доступные для предварительного заказа. По умолчанию ложно.
`source`	`string`	Строка для идентификации отправителя этого запроса.
`startIndex`	`unsigned integer`	Индекс первого возвращаемого результата (начинается с 0)

Тело запроса

Не указывайте тело запроса с этим методом.

Ответ

В случае успеха этот метод возвращает тело ответа со следующей структурой:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}

Имя свойства	Ценность	Описание
`kind`	`string`	Тип ресурса.
`items[]`	`list`	Список томов.
`totalItems`	`integer`	Общее количество найденных томов. Это может быть больше, чем количество томов, возвращенных в этом ответе, если результаты разбиты на страницы.

Попытайся!

Используйте проводник ниже, чтобы вызвать этот метод для оперативных данных и посмотреть ответ.