Volumen

Una colección Volume se usa para realizar una búsqueda o enumerar el contenido de una biblioteca. Esta colección es de solo lectura.

Métodos

Los siguientes métodos se aplican a los datos públicos sobre los volúmenes y no requieren autenticación.
books.volumes.list
books.volumes.get

El siguiente método se aplica a la vista privada "Mi biblioteca" de los volúmenes y requiere autenticación.
books.mylibrary.bookshelves.volumes.list

get
Recupera un recurso de volumen según el ID.
list
Realiza una búsqueda de libros.

Representaciones de recursos

Un volumen representa la información que aloja Google Libros sobre un libro o una revista. Contiene metadatos, como el título y el autor, así como datos personalizados, como si se compró o no. (A continuación, se indican los campos de volumen que están disponibles en la proyección 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
  }
}
Nombre de la propiedad Valor Descripción Notas
kind string Es el tipo de recurso de un volumen. (en proyección LITE).
id string Es el identificador único de un volumen. (En proyección LITE).
etag string Es un identificador opaco para una versión específica de un recurso de volumen. (En proyección LITE)
volumeInfo object Información general del volumen.
volumeInfo.title string Título del volumen. (En proyección LITE).
volumeInfo.subtitle string Subtítulo del volumen. (en proyección LITE).
volumeInfo.authors[] list Los nombres de los autores o editores de este volumen. (En proyección LITE)
volumeInfo.publisher string Es el editor de este volumen. (En proyección LITE).
volumeInfo.publishedDate string Es la fecha de publicación. (En proyección LITE).
volumeInfo.description string Es un resumen del volumen. El texto de la descripción tiene formato HTML y, además, incluye elementos de formato simples, como las etiquetas b, i y br. (en proyección LITE)
volumeInfo.industryIdentifiers[] list Son los identificadores estándar de la industria para este volumen.
volumeInfo.industryIdentifiers[].type string Tipo de identificador. Los valores posibles son ISBN_10, ISBN_13, ISSN y OTHER.
volumeInfo.industryIdentifiers[].identifier string Identificador de volumen específico de la industria.
volumeInfo.pageCount integer Cantidad total de páginas.
volumeInfo.dimensions object Dimensiones físicas de este volumen.
volumeInfo.dimensions.height string Es la altura o longitud de este volumen (en cm).
volumeInfo.dimensions.width string Es el ancho de este volumen (en cm).
volumeInfo.dimensions.thickness string Grosor de este volumen (en cm).
volumeInfo.printType string Es el tipo de publicación de este volumen. Los valores posibles son BOOK o MAGAZINE.
volumeInfo.categories[] list Es una lista de categorías de temas, como "Ficción", "Suspense", etcétera.
volumeInfo.averageRating double Es la calificación promedio de las opiniones de este volumen. (mín. = 1.0, máx. = 5.0)
volumeInfo.ratingsCount integer Es la cantidad de calificaciones de opiniones de este volumen.
volumeInfo.contentVersion string Es un identificador para la versión del contenido del volumen (texto e imágenes). (En proyección LITE)
volumeInfo.imageLinks.thumbnail string Es el vínculo a la imagen para el tamaño de miniatura (ancho de alrededor de 128 píxeles). (en proyección LITE)
volumeInfo.imageLinks.small string Vínculo de imagen para tamaño pequeño (ancho de aprox. 300 píxeles). (en proyección LITE)
volumeInfo.imageLinks.medium string Vínculo de imagen para tamaño mediano (ancho aproximado de 575 píxeles). (en proyección LITE)
volumeInfo.imageLinks.large string Vínculo a la imagen para tamaño grande (ancho de alrededor de 800 píxeles). (en proyección LITE)
volumeInfo.imageLinks.smallThumbnail string Vínculo de imagen para una miniatura pequeña (ancho de unos 80 píxeles). (en proyección LITE)
volumeInfo.imageLinks.extraLarge string Es un vínculo a una imagen de tamaño extra grande (ancho de alrededor de 1,280 píxeles). (en proyección LITE)
volumeInfo.language string Es el mejor idioma para este volumen (según el contenido). Es el código ISO 639-1 de dos letras, como “fr”, “en”, etcétera.
volumeInfo.mainCategory string Es la categoría principal a la que pertenece este volumen. Será la categoría de la lista de categorías que se muestra a continuación que tenga el mayor peso.
userInfo object Información específica del usuario relacionada con este volumen. (p.ej., la página que leyó por última vez este usuario o si compró este libro)
userInfo.review nested object La opinión de este usuario sobre este volumen, si existe.
userInfo.readingPosition readingPosition Resource La posición de lectura actual del usuario en el volumen, si hay una disponible (En proyección LITE).
userInfo.isPurchased boolean Indica si el usuario autenticado que realiza la solicitud compró este volumen o no. (En proyección LITE).
saleInfo object Cualquier información sobre un volumen relacionada con la tienda de libros electrónicos o la capacidad de compra Esta información puede depender del país donde se origina la solicitud (es decir, es posible que los libros no estén a la venta en ciertos países).
saleInfo.country string Es el código de país ISO_3166-1 de dos letras para el que es válida esta información de venta. (En proyección LITE).
saleInfo.saleability string Si el libro está disponible para la venta o se ofrece de forma gratuita en Google eBookstore para el país mencionado anteriormente Los valores posibles son FOR_SALE, FREE, NOT_FOR_SALE o FOR_PREORDER.
saleInfo.isEbook boolean Indica si el volumen es un libro electrónico (se puede agregar a la biblioteca Mis libros electrónicos).
saleInfo.listPrice object Es el precio de venta minorista sugerido. (en proyección LITE)
saleInfo.listPrice.amount double Es el importe en la moneda que se indica a continuación. (en proyección LITE).
saleInfo.listPrice.currencyCode string Es un código de moneda ISO 4217 de tres letras. (En proyección LITE).
saleInfo.retailPrice object Es el precio de venta real del libro. Es el mismo que el precio de venta minorista o de lista sugerido, a menos que haya ofertas o descuentos en este volumen. (en proyección LITE)
saleInfo.retailPrice.amount double Es el importe en la moneda que se indica a continuación. (en proyección LITE).
saleInfo.retailPrice.currencyCode string Es un código de moneda de tres letras según la norma ISO 4217. (en proyección LITE).
accessInfo object Cualquier información sobre un volumen relacionada con la lectura o la obtención del texto de ese volumen Esta información puede depender del país (los libros pueden ser de dominio público en un país, pero no en otro, por ejemplo).
accessInfo.country string El código de país ISO_3166-1 de dos letras para el que es válida esta información de acceso. (En proyección LITE).
accessInfo.viewability string Es el acceso de lectura de un volumen. Los valores posibles son PARTIAL, ALL_PAGES, NO_PAGES o UNKNOWN. Este valor depende del país mencionado anteriormente. Un valor PARCIAL significa que el publicador permitió que se vea de forma pública una parte del volumen, sin realizar compras. Esto puede aplicarse tanto a los libros electrónicos como a los que no lo sean. Los libros de dominio público siempre tendrán un valor de ALL_PAGES.
accessInfo.epub object Información sobre el contenido EPUB. (en proyección LITE)
accessInfo.pdf object Información sobre el contenido en PDF. (en proyección LITE)
accessInfo.accessViewStatus string Combina el acceso y la visibilidad de este volumen en un solo campo de estado para este usuario. Los valores pueden ser FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE o NONE. (En proyección LITE).
accessInfo.embeddable boolean Indica si este volumen se puede incorporar en un viewport con la API de Embedded Viewer.
accessInfo.publicDomain boolean Si el libro es de dominio público o no en el país mencionado anteriormente
userInfo.updated datetime Es la marca de tiempo de la última vez que una acción del usuario modificó este volumen, como una actualización de la posición de lectura, la compra del volumen o la escritura de una opinión. (formato de fecha y hora UTC RFC 3339).
userInfo.isPreordered boolean Indica si el usuario autenticado que realizó la solicitud pidió o no este volumen por adelantado. (En proyección LITE).
saleInfo.onSaleDate datetime Es la fecha en la que el libro está disponible para la venta.
accessInfo.textToSpeechPermission string Indica si se permite la función de texto a voz para este volumen. Los valores pueden ser ALLOWED, ALLOWED_FOR_ACCESSIBILITY o NOT_ALLOWED.
accessInfo.epub.isAvailable boolean Es un epub de texto fluido disponible como dominio público o para comprar. (en proyección LITE).
accessInfo.pdf.isAvailable boolean Es un PDF de imagen escaneada que está disponible como de dominio público o para compra. (En proyección LITE).
accessInfo.downloadAccess nested object Información sobre las restricciones de acceso a la licencia de descarga de un volumen.
accessInfo.downloadAccess.kind string Tipo de recurso.
accessInfo.downloadAccess.volumeId string Identifica el volumen para el que se aplica esta entrada.
accessInfo.downloadAccess.restricted boolean Indica si este volumen tiene restricciones de acceso de descarga.
accessInfo.downloadAccess.deviceAllowed boolean Si se restringe, indica si se otorga el acceso (usuario, dispositivo, volumen).
accessInfo.downloadAccess.justAcquired boolean Si deviceAllowed, indica si se acaba de adquirir el acceso con esta solicitud.
accessInfo.downloadAccess.maxDownloadDevices integer Si está restringida, la cantidad máxima de licencias de descarga de contenido para este volumen
accessInfo.downloadAccess.downloadsAcquired integer Si está restringida, la cantidad de licencias de descarga de contenido que ya se adquirieron (incluido el cliente solicitante, si tiene licencia)
accessInfo.downloadAccess.nonce string Nonce del cliente para la verificación. Solo acceso de descarga y validación de clientes.
accessInfo.downloadAccess.source string Es el identificador de la app cliente para la verificación. Solo acceso de descarga y validación de clientes.
accessInfo.downloadAccess.reasonCode string Código de motivo de error o advertencia. Es posible que se agreguen códigos adicionales en el futuro. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
accessInfo.downloadAccess.message string Mensaje de error o advertencia
accessInfo.downloadAccess.signature string Firma de la respuesta.
searchInfo object Información de los resultados de la búsqueda relacionada con este volumen.
searchInfo.textSnippet string Es un fragmento de texto que contiene la consulta de búsqueda.