Коллекция
Volume
используется для поиска или составления списка содержимого книжной полки. Эта коллекция доступна только для чтения. Методы
Следующие методы применимы к общедоступным данным о томах и не требуют аутентификации.
книги.тома.список books.volumes.get
Следующий метод применяется к частному представлению томов «Моя библиотека» и требует аутентификации.
book.mylibrary.bookshelves.volumes.list- получать
- Получает ресурс тома на основе идентификатора.
- список
- Выполняет поиск книг.
Представления ресурсов
Том представляет собой информацию о книге или журнале, которую размещает Google Книги. Он содержит метаданные, такие как название и автор, а также персонализированные данные, например о том, было ли оно куплено. (Поля объема, доступные в проекции LITE, указаны ниже).
{ "kind": "books#volume", "id": string, "etag": string, "selfLink": string, "volumeInfo": { "title": string, "subtitle": string, "authors": [ string ], "publisher": string, "publishedDate": string, "description": string, "industryIdentifiers": [ { "type": string, "identifier": string } ], "pageCount": integer, "dimensions": { "height": string, "width": string, "thickness": string }, "printType": string, "mainCategory": string, "categories": [ string ], "averageRating": double, "ratingsCount": integer, "contentVersion": string, "imageLinks": { "smallThumbnail": string, "thumbnail": string, "small": string, "medium": string, "large": string, "extraLarge": string }, "language": string, "previewLink": string, "infoLink": string, "canonicalVolumeLink": string }, "userInfo": { "review": mylibrary.reviews Resource, "readingPosition": mylibrary.readingpositions Resource, "isPurchased": boolean, "isPreordered": boolean, "updated": datetime }, "saleInfo": { "country": string, "saleability": string, "onSaleDate": datetime, "isEbook": boolean, "listPrice": { "amount": double, "currencyCode": string }, "retailPrice": { "amount": double, "currencyCode": string }, "buyLink": string }, "accessInfo": { "country": string, "viewability": string, "embeddable": boolean, "publicDomain": boolean, "textToSpeechPermission": string, "epub": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "pdf": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "webReaderLink": string, "accessViewStatus": string, "downloadAccess": { "kind": "books#downloadAccessRestriction", "volumeId": string, "restricted": boolean, "deviceAllowed": boolean, "justAcquired": boolean, "maxDownloadDevices": integer, "downloadsAcquired": integer, "nonce": string, "source": string, "reasonCode": string, "message": string, "signature": string } }, "searchInfo": { "textSnippet": string } }
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
kind | string | Тип ресурса для тома. (В проекции LITE.) | |
id | string | Уникальный идентификатор тома. (В проекции LITE.) | |
etag | string | Непрозрачный идентификатор конкретной версии ресурса тома. (В проекции LITE) | |
selfLink | string | URL-адрес этого ресурса. (В проекции LITE.) | |
volumeInfo | object | Общая информация об объеме. | |
volumeInfo. title | string | Название тома. (В проекции LITE.) | |
volumeInfo. subtitle | string | Объемный субтитр. (В проекции LITE.) | |
volumeInfo. authors[] | list | Имена авторов и/или редакторов этого тома. (В проекции LITE) | |
volumeInfo. publisher | string | Издатель этого тома. (В проекции LITE.) | |
volumeInfo. publishedDate | string | Дата публикации. (В проекции LITE.) | |
volumeInfo. description | string | Краткое содержание тома. Текст описания форматируется в HTML и включает простые элементы форматирования, такие как теги b, i и br. (в проекции LITE) | |
volumeInfo. industryIdentifiers[] | list | Стандартные идентификаторы для этого тома. | |
volumeInfo.industryIdentifiers[]. type | string | Тип идентификатора. Возможные значения: ISBN_10, ISBN_13, ISSN и OTHER. | |
volumeInfo.industryIdentifiers[]. identifier | string | Отраслевой идентификатор тома. | |
volumeInfo. pageCount | integer | Общее количество страниц. | |
volumeInfo. dimensions | object | Физические размеры этого объема. | |
volumeInfo.dimensions. height | string | Высота или длина этого тома (в см). | |
volumeInfo.dimensions. width | string | Ширина этого объема (в см). | |
volumeInfo.dimensions. thickness | string | Толщина этого объема (в см). | |
volumeInfo. printType | string | Тип публикации этого тома. Возможные значения: КНИГА или ЖУРНАЛ. | |
volumeInfo. categories[] | list | Список тематических категорий, таких как «Художественная литература», «Саспенс» и т. д. | |
volumeInfo. averageRating | double | Средний рейтинг обзора для этого тома. (мин = 1,0, макс = 5,0) | |
volumeInfo. ratingsCount | integer | Количество оценок рецензий для этого тома. | |
volumeInfo. contentVersion | string | Идентификатор версии содержимого тома (текст и изображения). (В проекции LITE) | |
volumeInfo. imageLinks | object | Список ссылок на изображения для всех доступных размеров. (в проекции LITE) | |
volumeInfo.imageLinks. thumbnail | string | Ссылка на изображение для размера миниатюры (ширина ~ 128 пикселей). (в проекции LITE) | |
volumeInfo.imageLinks. small | string | Ссылка на изображение небольшого размера (ширина ~300 пикселей). (в проекции LITE) | |
volumeInfo.imageLinks. medium | string | Ссылка на изображение среднего размера (ширина ~575 пикселей). (в проекции LITE) | |
volumeInfo.imageLinks. large | string | Ссылка на изображение большого размера (ширина ~800 пикселей). (в проекции LITE) | |
volumeInfo.imageLinks. smallThumbnail | string | Ссылка на изображение для миниатюр небольшого размера (ширина ~80 пикселей). (в проекции LITE) | |
volumeInfo.imageLinks. extraLarge | string | Ссылка на изображение для очень большого размера (ширина ~1280 пикселей). (в проекции LITE) | |
volumeInfo. language | string | Лучший язык для этого тома (в зависимости от содержания). Это двухбуквенный код ISO 639-1, например «fr», «en» и т. д. | |
volumeInfo. mainCategory | string | Основная категория, к которой относится данный том. Это будет категория из приведенного ниже списка категорий, имеющая наибольший вес. | |
volumeInfo. previewLink | string | URL-адрес для предварительного просмотра этого тома на сайте Google Книги. | |
userInfo | object | Информация для конкретного пользователя, относящаяся к этому тому. (например, страница, которую последний раз читал этот пользователь или купили ли они эту книгу) | |
userInfo. review | nested object | Обзор этого тома, сделанный пользователем, если таковой существует. | |
userInfo. readingPosition | readingPosition Resource | Текущая позиция чтения пользователя в томе, если таковая имеется. (В проекции LITE.) | |
userInfo. isPurchased | boolean | Был ли этот том приобретен авторизованным пользователем, сделавшим запрос. (В проекции LITE.) | |
saleInfo | object | Любая информация о томе, связанная с электронным книжным магазином и/или возможностью приобретения. Эта информация может зависеть от страны, из которой поступил запрос (т. е. книги могут не продаваться в некоторых странах). | |
saleInfo. country | string | Двухбуквенный код страны ISO_3166-1, для которого действительна эта информация о продаже. (В проекции LITE.) | |
saleInfo. saleability | string | Доступна ли эта книга для продажи или предлагается бесплатно в магазине электронных книг Google для указанной выше страны. Возможные значения: FOR_SALE, FREE, NOT_FOR_SALE или FOR_PREORDER. | |
saleInfo. isEbook | boolean | Является ли этот том электронной книгой (можно добавить на полку «Мои электронные книги»). | |
saleInfo. listPrice | object | Рекомендованная розничная цена. (в проекции LITE) | |
saleInfo.listPrice. amount | double | Сумма в валюте указана ниже. (В проекции LITE.) | |
saleInfo.listPrice. currencyCode | string | Трехбуквенный код валюты ISO 4217. (В проекции LITE.) | |
saleInfo. retailPrice | object | Реальная цена продажи книги. Это то же самое, что рекомендованная розничная или прейскурантная цена, если на этот объем не действуют предложения или скидки. (в проекции LITE) | |
saleInfo.retailPrice. amount | double | Сумма в валюте указана ниже. (В проекции LITE.) | |
saleInfo.retailPrice. currencyCode | string | Трехбуквенный код валюты ISO 4217. (В проекции LITE.) | |
saleInfo. buyLink | string | URL-адрес для покупки этого тома на сайте Google Книги. (в проекции LITE) | |
accessInfo | object | Любая информация о томе, связанная с чтением или получением текста этого тома. Эта информация может зависеть от страны (например, книги могут быть общественным достоянием в одной стране, но не в другой). | |
accessInfo. country | string | Двухбуквенный код страны ISO_3166-1, для которого действительна эта информация о доступе. (В проекции LITE.) | |
accessInfo. viewability | string | Доступ на чтение тома. Возможные значения: PARTIAL, ALL_PAGES, NO_PAGES или UNKNOWN. Это значение зависит от страны, указанной выше. Значение PARTIAL означает, что издатель разрешил общедоступный просмотр некоторой части тома без покупки. Это может относиться как к электронным книгам, так и к неэлектронным книгам. Книги, являющиеся общественным достоянием, всегда будут иметь значение ALL_PAGES. | |
accessInfo. epub | object | Информация о контенте epub. (в проекции LITE) | |
accessInfo.epub. downloadLink | string | URL-адрес для загрузки epub. (В проекции LITE.) | |
accessInfo.epub. acsTokenLink | string | URL-адрес для получения токена ACS для загрузки epub. (В проекции LITE.) | |
accessInfo. pdf | object | Информация о pdf-контенте. (в проекции LITE) | |
accessInfo.pdf. downloadLink | string | URL для скачивания PDF. (В проекции LITE.) | |
accessInfo.pdf. acsTokenLink | string | URL-адрес для получения токена ACS для загрузки в формате PDF. (В проекции LITE.) | |
accessInfo. accessViewStatus | string | Объединяет доступ и видимость этого тома в одном поле статуса для этого пользователя. Значения могут быть FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE или NONE. (В проекции LITE.) | |
accessInfo. embeddable | boolean | Можно ли встроить этот том в область просмотра с помощью API Embedded Viewer. | |
accessInfo. publicDomain | boolean | Является ли эта книга общественным достоянием в указанной выше стране. | |
infoLink | string | URL-адрес для просмотра информации об этом томе на сайте Google Книги. (В проекции LITE) | |
userInfo. updated | datetime | Отметка времени, когда этот том был последний раз изменен действием пользователя, например обновлением позиции чтения, покупкой тома или написанием обзора. (формат даты и времени RFC 3339 UTC). | |
volumeInfo. canonicalVolumeLink | string | Канонический URL-адрес тома. (В проекции LITE.) | |
userInfo. isPreordered | boolean | Был ли этот том предварительно заказан авторизованным пользователем, сделавшим запрос. (В проекции LITE.) | |
saleInfo. onSaleDate | datetime | Дата поступления этой книги в продажу. | |
accessInfo. textToSpeechPermission | string | Разрешено ли преобразование текста в речь для этого тома. Возможные значения: ALLOWED, ALLOWED_FOR_ACCESSIBILITY или NOT_ALLOWED. | |
accessInfo.epub. isAvailable | boolean | Доступен ли текстовый файл epub в свободном доступе или для покупки. (В проекции LITE.) | |
accessInfo.pdf. isAvailable | boolean | Доступно ли отсканированное изображение в формате PDF как общественное достояние или для покупки. (В проекции LITE.) | |
accessInfo. webReaderLink | string | URL-адрес для чтения этого тома на сайте Google Книги. Ссылка не позволит пользователям читать непросматриваемые тома. | |
accessInfo. downloadAccess | nested object | Информация об ограничениях доступа к лицензии на загрузку тома. | |
accessInfo.downloadAccess. kind | string | Тип ресурса. | |
accessInfo.downloadAccess. volumeId | string | Идентифицирует том, к которому применяется эта запись. | |
accessInfo.downloadAccess. restricted | boolean | Имеет ли этот том какие-либо ограничения на доступ к загрузке. | |
accessInfo.downloadAccess. deviceAllowed | boolean | Если ограничено, предоставляется ли для этого доступ (пользователь, устройство, том). | |
accessInfo.downloadAccess. justAcquired | boolean | Если deviceAllowed, был ли доступ только что получен с помощью этого запроса. | |
accessInfo.downloadAccess. maxDownloadDevices | integer | Если ограничение ограничено, максимальное количество лицензий на загрузку контента для этого тома. | |
accessInfo.downloadAccess. downloadsAcquired | integer | Если ограничение ограничено, количество уже приобретенных лицензий на загрузку контента (включая запрашивающего клиента, если он есть). | |
accessInfo.downloadAccess. nonce | string | Клиентский одноразовый номер для проверки. Только доступ к загрузке и проверка клиента. | |
accessInfo.downloadAccess. source | string | Идентификатор клиентского приложения для проверки. Только доступ к загрузке и проверка клиента. | |
accessInfo.downloadAccess. reasonCode | string | Код причины ошибки/предупреждения. В будущем могут быть добавлены дополнительные коды. 0 ОК 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS | |
accessInfo.downloadAccess. message | string | Сообщение об ошибке/предупреждение. | |
accessInfo.downloadAccess. signature | string | Подпись ответа. | |
searchInfo | object | Информация о результатах поиска, относящаяся к этому тому. | |
searchInfo. textSnippet | string | Текстовый фрагмент, содержащий поисковый запрос. |