Volumen

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)
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.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.
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).
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.pdf object Información sobre el contenido 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.
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).
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.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.