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