Коллекция
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 | Текстовый фрагмент, содержащий поисковый запрос. |