Том: список
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Выполняет поиск книг. Попробуйте сейчас .
Запрос
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 | Общее количество найденных томов. Это число может быть больше, чем количество томов, возвращенных в этом ответе, если результаты разбиты на страницы. | |
Попробуйте!
Используйте проводник ниже, чтобы вызвать этот метод для реальных данных и увидеть ответ.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-15 UTC.
[null,null,["Последнее обновление: 2024-11-15 UTC."],[[["\u003cp\u003eSearches for books based on a provided query string.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by criteria such as availability, format, language, and publication type.\u003c/p\u003e\n"],["\u003cp\u003eOffers control over the number of results, sorting order, and specific data fields returned.\u003c/p\u003e\n"],["\u003cp\u003eCan be used to retrieve information about books, including volume details and access options.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to handle large result sets.\u003c/p\u003e\n"]]],[],null,["# Volume: list\n\nPerforms a book search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n GET https://www.googleapis.com/books/v1/volumes?q={search terms}\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-------------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `q` | `string` | Full-text search query string. |\n| **Optional Parameters** |||\n| `download` | `string` | Restrict to volumes by download availability. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`epub`\" - All volumes with epub. |\n| `filter` | `string` | Filter search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`ebooks`\" - All Google eBooks. - \"`free-ebooks`\" - Google eBook with full volume text viewability. - \"`full`\" - Public can view entire volume text. - \"`paid-ebooks`\" - Google eBook with a price. - \"`partial`\" - Public able to see parts of text. |\n| `langRestrict` | `string` | Restrict results to books with this language code. |\n| `libraryRestrict` | `string` | Restrict search to this user's library. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`my-library`\" - Restrict to the user's library, any shelf. - \"`no-restrict`\" - Do not restrict based on user's library. |\n| `maxResults` | `unsigned integer` | Maximum number of results to return. Acceptable values are `0` to `40`, inclusive. |\n| `orderBy` | `string` | Sort search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`newest`\" - Most recently published. - \"`relevance`\" - Relevance to search terms. |\n| `partner` | `string` | Restrict and brand results for partner ID. |\n| `printType` | `string` | Restrict to books or magazines. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\" - All volume content types. - \"`books`\" - Just books. - \"`magazines`\" - Just magazines. |\n| `projection` | `string` | Restrict information returned to a set of selected fields. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`full`\" - Includes all volume data. - \"`lite`\" - Includes a subset of fields in volumeInfo and accessInfo. |\n| `showPreorders` | `boolean` | Set to true to show books available for preorder. Defaults to false. |\n| `source` | `string` | String to identify the originator of this request. |\n| `startIndex` | `unsigned integer` | Index of the first result to return (starts at 0) |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n {\n \"kind\": \"books#volumes\",\n \"items\": [\n volume Resource\n ],\n \"totalItems\": (value)\n }\n\n| Property Name | Value | Description | Notes |\n|---------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `items[]` | `list` | A list of volumes. | |\n| `totalItems` | `integer` | Total number of volumes found. This might be greater than the number of volumes returned in this response if results have been paginated. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]
