Объем

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