Коллекция
Volume
используется для выполнения поиска или перечисления содержимого книжной полки. Эта коллекция доступна только для чтения.Методы
Следующие методы применяются к общедоступным данным о томах и не требуют аутентификации.
книги.тома.список book.volumes.get
Следующий метод применяется к частному представлению томов «Моя библиотека» и требует проверки подлинности.
books.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. (в ЛАЙТ проекции) | |
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 | Список ссылок на изображения для всех доступных размеров. (в ЛАЙТ проекции) | |
volumeInfo.imageLinks. thumbnail | string | Ссылка на изображение для размера эскиза (ширина ~ 128 пикселей). (в ЛАЙТ проекции) | |
volumeInfo.imageLinks. small | string | Ссылка на изображение для небольшого размера (ширина ~300 пикселей). (в ЛАЙТ проекции) | |
volumeInfo.imageLinks. medium | string | Ссылка на изображение среднего размера (ширина ~575 пикселей). (в ЛАЙТ проекции) | |
volumeInfo.imageLinks. large | string | Ссылка на изображение большого размера (ширина ~800 пикселей). (в ЛАЙТ проекции) | |
volumeInfo.imageLinks. smallThumbnail | string | Ссылка на изображение для небольшого размера эскиза (ширина ~ 80 пикселей). (в ЛАЙТ проекции) | |
volumeInfo.imageLinks. extraLarge | string | Ссылка на изображение для очень большого размера (ширина ~ 1280 пикселей). (в ЛАЙТ проекции) | |
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 | Рекомендованная розничная цена. (в ЛАЙТ проекции) | |
saleInfo.listPrice. amount | double | Сумма в валюте, указанной ниже. (В проекции LITE.) | |
saleInfo.listPrice. currencyCode | string | Трехбуквенный код валюты ISO 4217. (В проекции LITE.) | |
saleInfo. retailPrice | object | Фактическая цена продажи книги. Это то же самое, что и рекомендуемая розничная цена или цена по прейскуранту, если только на этот объем не действуют предложения или скидки. (в ЛАЙТ проекции) | |
saleInfo.retailPrice. amount | double | Сумма в валюте, указанной ниже. (В проекции LITE.) | |
saleInfo.retailPrice. currencyCode | string | Трехбуквенный код валюты ISO 4217. (В проекции LITE.) | |
saleInfo. buyLink | string | URL для покупки этого тома на сайте Google Книг. (в ЛАЙТ проекции) | |
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. (в ЛАЙТ проекции) | |
accessInfo.epub. downloadLink | string | URL для загрузки epub. (В проекции LITE.) | |
accessInfo.epub. acsTokenLink | string | URL-адрес для получения токена ACS для загрузки epub. (В проекции LITE.) | |
accessInfo. pdf | object | Информация о содержимом pdf. (в ЛАЙТ проекции) | |
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 | Можно ли встроить этот объем в область просмотра с помощью Embedded Viewer API. | |
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 | Электронный паб с плавным текстом доступен либо как общественное достояние, либо для покупки. (В проекции 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 OK 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 | Фрагмент текста, содержащий поисковый запрос. |