Una colección de
Volume
se usa para realizar una búsqueda o hacer una lista del 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 volúmenes y no requieren autenticación.
books.volumes.list.books.volumes.get.
El siguiente método se aplica a la vista privada de "Mi biblioteca" de volúmenes y requiere autenticación.
books.mylibrary.bookbookshelf.volumes.list.- obtener
- Recupera un recurso de volumen basado en el ID.
- list
- Realiza una búsqueda de libros.
Representaciones de recursos
Un volumen representa información que Google Libros aloja sobre un libro o una revista. Contiene metadatos, como el título y el autor, datos personalizados, como si se compraron o no. (Los campos de volumen que están disponibles en la proyección LITE se indican a continuación).
{ "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 |
Identificador único de un volumen (en proyección LITE). | |
etag |
string |
Identificador opaco para una versión específica de un recurso de volumen. (en proyección LITE) | |
selfLink |
string |
URL a 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 |
Editor de este volumen. (en proyección LITE). | |
volumeInfo.publishedDate |
string |
Fecha de publicación. (en proyección LITE). | |
volumeInfo.description |
string |
Una sinopsis del volumen. El texto de la descripción tiene formato HTML e incluye elementos de formato simple, como etiquetas b, i y br. (en proyección LITE) | |
volumeInfo.industryIdentifiers[] |
list |
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 |
Número total de páginas. | |
volumeInfo.dimensions |
object |
Dimensiones físicas de este volumen. | |
volumeInfo.dimensions.height |
string |
Altura o longitud de este volumen (en cm). | |
volumeInfo.dimensions.width |
string |
Ancho de este volumen (en cm). | |
volumeInfo.dimensions.thickness |
string |
Espesor de este volumen (en cm). | |
volumeInfo.printType |
string |
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. | |
volumeInfo.averageRating |
double |
Es la calificación media de las opiniones para este volumen. (mín. = 1.0, máx. = 5.0) | |
volumeInfo.ratingsCount |
integer |
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 imágenes 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 ~128 píxeles). (en proyección LITE) | |
volumeInfo.imageLinks.small |
string |
Vínculo de imagen para tamaño pequeño (ancho de ~300 píxeles). (en proyección LITE) | |
volumeInfo.imageLinks.medium |
string |
Vínculo de imagen para tamaño mediano (ancho de ~575 píxeles). (en proyección LITE) | |
volumeInfo.imageLinks.large |
string |
Vínculo de imagen para tamaño grande (ancho de ~800 píxeles). (en proyección LITE) | |
volumeInfo.imageLinks.smallThumbnail |
string |
Vínculo de imagen para una miniatura pequeña (ancho de ~80 píxeles). (en proyección LITE) | |
volumeInfo.imageLinks.extraLarge |
string |
Vínculo de imagen para un tamaño extragrande (ancho de ~1280 píxeles). (en proyección LITE) | |
volumeInfo.language |
string |
El mejor idioma para este volumen (según el contenido). Corresponde al 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. Será la categoría de la lista de categorías que se muestra a continuación que tiene el peso más alto. | |
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 página en la que este usuario leyó por última vez o si compró este libro) | |
userInfo.review |
nested object |
La opinión de este usuario sobre este volumen, si existe | |
userInfo.readingPosition |
readingPosition Resource |
Indica la posición actual de lectura del volumen en el usuario, si se encuentra disponible. (en proyección LITE). | |
userInfo.isPurchased |
boolean |
Indica si el volumen autenticado compró el volumen o no por el usuario autenticado que realiza la solicitud. (en proyección LITE). | |
saleInfo |
object |
Cualquier información sobre un volumen relacionado con la tienda de libros electrónicos o la 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 |
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 |
Indica si este libro está disponible para la venta o se ofrece de forma gratuita en Google eBookstore para el país indicado anteriormente. Los valores posibles son FOR_SALE, FREE, NOT_FOR_SALE o FOR_PREORDER. | |
saleInfo.isEbook |
boolean |
Indica si este volumen es un eBook o no (se puede agregar a la estantería Mis eBooks). | |
saleInfo.listPrice |
object |
Precio minorista sugerido. (en proyección LITE) | |
saleInfo.listPrice.amount |
double |
Importe en la siguiente moneda. (en proyección LITE). | |
saleInfo.listPrice.currencyCode |
string |
Un código de moneda ISO 4217 de tres letras. (en proyección LITE). | |
saleInfo.retailPrice |
object |
El precio de venta real del libro. Este valor es el mismo que el precio sugerido de venta o de venta minorista, a menos que haya ofertas o descuentos en este volumen. (en proyección LITE) | |
saleInfo.retailPrice.amount |
double |
Importe en la siguiente moneda. (en proyección LITE). | |
saleInfo.retailPrice.currencyCode |
string |
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 ese texto. Esta información puede depender del país (los libros pueden ser de dominio público en un país, pero no en otro, p. ej., | |
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 que se indicó anteriormente. Un valor PARTIAL significa que el publicador permitió que una parte del volumen se vea públicamente, sin compra. Esto se puede aplicar tanto a los libros electrónicos como a los que no sean libros electrónicos. Los libros de dominio público siempre tendrán un valor de ALL_PAGES. | |
accessInfo.epub |
object |
Información sobre el contenido de epub. (en proyección LITE) | |
accessInfo.epub.downloadLink |
string |
URL para descargar el archivo epub (en proyección LITE). | |
accessInfo.epub.acsTokenLink |
string |
URL a fin de recuperar el token de ACS para la descarga de archivos epub. (en proyección LITE). | |
accessInfo.pdf |
object |
Información sobre el contenido PDF (en proyección LITE) | |
accessInfo.pdf.downloadLink |
string |
URL para descargar el PDF (en proyección LITE). | |
accessInfo.pdf.acsTokenLink |
string |
URL a fin de recuperar el token ACS para la descarga 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 |
Si se puede incorporar este volumen en un viewport mediante la API de Embed Viewer | |
accessInfo.publicDomain |
boolean |
Indica si este libro es de dominio público en el país que se menciona más arriba. | |
|
string |
URL para ver información sobre este volumen en el sitio de Google Libros. (en proyección LITE) | |
userInfo.updated |
datetime |
La marca de tiempo de la última vez que un usuario modificó este volumen, como una actualización de la posición de lectura, una compra de volumen o una reseña. (Formato de fecha y hora UTC de RFC 3339). | |
volumeInfo.canonicalVolumeLink |
string |
URL canónica para un volumen. (en proyección LITE). | |
userInfo.isPreordered |
boolean |
Indica si el volumen autenticado fue pedido por adelantado por el usuario autenticado que realizó la solicitud. (en proyección LITE). | |
saleInfo.onSaleDate |
datetime |
Fecha en la que este libro está disponible para la venta | |
accessInfo.textToSpeechPermission |
string |
Indica si se permite la conversión de texto a voz en 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 dominio público o para la compra. (en proyección LITE). | |
accessInfo.pdf.isAvailable |
boolean |
Es una imagen escaneada en formato pdf disponible como dominio público o para la 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 de las licencias de descarga de un volumen. | |
accessInfo.downloadAccess.kind |
string |
Tipo de recurso. | |
accessInfo.downloadAccess.volumeId |
string |
Identifica el volumen al que se aplica esta entrada. | |
accessInfo.downloadAccess.restricted |
boolean |
Indica si este volumen tiene restricciones de acceso a las descargas. | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
Si se restringe, indica si se otorgó acceso para esto (usuario, dispositivo, volumen). | |
accessInfo.downloadAccess.justAcquired |
boolean |
Si deviceAllowed, indica si se adquirió el acceso con esta solicitud. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
Si está restringido, la cantidad máxima de licencias de descarga de contenido para este volumen. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
Si está restringido, la cantidad de licencias de descarga de contenido ya adquirida (incluido el cliente solicitante, si tiene licencia). | |
accessInfo.downloadAccess.nonce |
string |
Nonce del cliente para 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 más códigos 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/advertencia. | |
accessInfo.downloadAccess.signature |
string |
Firma de la respuesta. | |
searchInfo |
object |
Es la información de los resultados de la búsqueda relacionada con este volumen. | |
searchInfo.textSnippet |
string |
Un fragmento de texto que contiene la búsqueda. |