Объем

Коллекция 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-проекции)
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. 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 Основная категория, к которой принадлежит этот том. Это будет категория из списка категорий, возвращаемого ниже, с наибольшим весом.
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.)
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. pdf object Информация о содержимом pdf. (в ЛАЙТ проекции)
accessInfo. accessViewStatus string Объединяет доступ и возможность просмотра этого тома в единое поле состояния для этого пользователя. Возможные значения: FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE или NONE. (В проекции LITE.)
accessInfo. embeddable boolean Можно ли встроить этот объем в область просмотра с помощью Embedded Viewer API.
accessInfo. publicDomain boolean Является ли эта книга общественным достоянием в стране, указанной выше.
userInfo. updated datetime Отметка времени последнего изменения этого тома действием пользователя, например обновлением позиции чтения, покупкой тома или написанием отзыва. (формат даты и времени RFC 3339 UTC).
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. 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 Фрагмент текста, содержащий поисковый запрос.