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.listbooks.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) | |
selfLink |
string |
URL de este recurso. (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 |
object |
Una lista de vínculos de imagen para todos los tamaños disponibles. (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. | |
volumeInfo.previewLink |
string |
URL para obtener una vista previa de este volumen en el sitio de Google Libros. | |
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). | |
saleInfo.buyLink |
string |
URL para comprar este volumen en el sitio de Google Libros. (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.epub.downloadLink |
string |
URL para descargar el archivo epub. (en proyección LITE). | |
accessInfo.epub.acsTokenLink |
string |
URL para recuperar el token de ACS para descargar epub. (en proyección LITE). | |
accessInfo.pdf |
object |
Información sobre el contenido del PDF. (en proyección LITE) | |
accessInfo.pdf.downloadLink |
string |
URL para descargar el PDF. (en proyección LITE). | |
accessInfo.pdf.acsTokenLink |
string |
URL para recuperar el token de ACS y descargar el 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. | |
|
string |
URL para ver información sobre este volumen en el sitio de Google Libros. (En proyección LITE) | |
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). | |
volumeInfo.canonicalVolumeLink |
string |
Es la URL canónica de un volumen. (en proyección LITE). | |
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.webReaderLink |
string |
URL para leer este volumen en el sitio de Google Libros. El vínculo no permitirá que los usuarios lean volúmenes no visibles. | |
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. |