Volumen

Se usa una colección Volume para buscar o mostrar el contenido de una estantería. 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 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 Volume representa la información que Google Libros aloja sobre un libro o una revista. Contiene metadatos, como el título y el autor, y datos personalizados, por ejemplo, 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 propiedad Valor Descripción Notas
kind string Tipo de recurso para un volumen. (en proyección LITE).
id string Es el identificador único de un volumen. (en proyección LITE).
etag string Es el 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 Publicador de este volumen. (en proyección LITE).
volumeInfo.publishedDate string Es la fecha de publicación. (en proyección LITE).
volumeInfo.description string Una sinopsis 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 Es la cantidad total de páginas.
volumeInfo.dimensions object Dimensiones físicas de este volumen.
volumeInfo.dimensions.height string Es la altura o la longitud de este volumen (en cm).
volumeInfo.dimensions.width string Ancho de este volumen (en cm).
volumeInfo.dimensions.thickness string Espesor del 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 Una lista de categorías de temas, como "Ficción", "Suspenso", etcétera
volumeInfo.averageRating double Es la calificación media de las opiniones para este volumen. (mínimo = 1.0, máximo = 5.0)
volumeInfo.ratingsCount integer Es la cantidad de calificaciones de opiniones para este volumen.
volumeInfo.contentVersion string Es un identificador para la versión del contenido del volumen (imágenes y texto). (En proyección LITE)
volumeInfo.imageLinks.thumbnail string Vínculo de imagen para el tamaño de la miniatura (ancho de unos 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 de imagen para tamaño grande (ancho de aprox. 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 Vínculo de imagen para un tamaño extragrande (ancho de unos 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.
volumeInfo.mainCategory string La categoría principal a la que pertenece este volumen. La categoría de la lista de categorías que se devuelve a continuación será la que tenga la ponderación más alta.
userInfo object Información específica del usuario relacionada con este volumen. (p.ej., la última página que leyó este usuario o si compró este libro)
userInfo.review nested object Es la opinión que realizó este usuario sobre este volumen, si existe.
userInfo.readingPosition readingPosition Resource Indica 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 realizó la solicitud compró o no este volumen. (en proyección LITE).
saleInfo object Cualquier información sobre un volumen relacionado 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 este libro está disponible para la venta o si se ofrece de forma gratuita en la Tienda de libros electrónicos de Google en el país mencionado anteriormente. Los valores posibles son FOR_SALE, FREE, NOT_FOR_SALE o FOR_PREORDER.
saleInfo.isEbook boolean Indica si este volumen es o no un libro electrónico (se puede agregar a la estantería 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. Este es el mismo que el precio de lista o de venta minorista 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 ISO 4217 de tres letras. (en proyección LITE).
accessInfo object Cualquier información sobre un volumen relacionado con la lectura o la obtención de 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 El acceso de lectura de un volumen. Los valores posibles son PARTIAL, ALL_PAGES, NO_PAGES o UNKNOWN. Este valor depende del país indicado 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 sean electrónicos. 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 del 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 Si este volumen se puede incorporar en un viewport a través de la API de visualizador incorporado.
accessInfo.publicDomain boolean Si este libro es de dominio público en el país mencionado anteriormente.
userInfo.updated datetime 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, una compra de volumen o la escritura de una opinión. (Formato de fecha y hora RFC 3339 UTC).
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 Si se permite texto a voz para este volumen. Los valores pueden ser ALLOWED, ALLOWED_FOR_ACCESSIBILITY o NOT_ALLOWED.
accessInfo.epub.isAvailable boolean Es un archivo epub de texto fluido disponible como de dominio público o para compra. (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 licencias 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 Si este volumen tiene restricciones de acceso a las descargas.
accessInfo.downloadAccess.deviceAllowed boolean Si se restringe si se otorga el acceso correspondiente (usuario, dispositivo, volumen).
accessInfo.downloadAccess.justAcquired boolean Si se muestra deviceAllowed, si se acaba de adquirir el acceso con esta solicitud.
accessInfo.downloadAccess.maxDownloadDevices integer Si se restringe, indica la cantidad máxima de licencias de descarga de contenido para este volumen.
accessInfo.downloadAccess.downloadsAcquired integer Si se restringe, indica la cantidad de licencias de descarga de contenido que ya adquiriste (incluido el cliente que realizó la solicitud, si tiene licencia).
accessInfo.downloadAccess.nonce string Nonce de cliente para la verificación Solo acceso para descarga y validación de cliente.
accessInfo.downloadAccess.source string Es el identificador de la app cliente para la verificación. Solo acceso para descarga y validación de cliente.
accessInfo.downloadAccess.reasonCode string Código de motivo de error o advertencia. Es posible que se agreguen códigos adicionales en el futuro. 0 ACEPTAR 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 Fragmento de texto que contiene la búsqueda.