Volumen: lista

Realiza una búsqueda de libros. Pruébalo ahora.

Solicitud

Solicitud HTTP

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

Parámetros

Nombre del parámetro Valor Descripción
Parámetros obligatorios
q string String de consulta de búsqueda de texto completo.
Parámetros opcionales
download string Restringir a volúmenes por disponibilidad de descarga

Los valores aceptables son los siguientes:
  • "epub": Todos los volúmenes con epub.
filter string Filtrar los resultados de la búsqueda.

Los valores aceptables son los siguientes:
  • "ebooks": todos los Google eBooks
  • "free-ebooks" - Google eBook con visibilidad de texto en volumen completo.
  • "full": el público puede ver el texto completo del volumen.
  • "paid-ebooks": Google eBook con un precio.
  • "partial": el público puede ver partes de texto.
langRestrict string Restringir resultados a libros con este código de idioma
libraryRestrict string Restringir la búsqueda a la biblioteca de este usuario

Los valores aceptables son los siguientes:
  • "my-library": Restringir a la biblioteca del usuario, a cualquier biblioteca.
  • "no-restrict": No restringir según la biblioteca del usuario.
maxResults unsigned integer Cantidad máxima de resultados que se mostrarán Los valores aceptables son 0 a 40, ambos inclusive.
orderBy string Ordenar resultados de búsqueda.

Los valores aceptables son los siguientes:
  • "newest": el que se publicó más recientemente.
  • "relevance": Relevancia para los términos de búsqueda.
partner string Restringir y generar resultados según el ID de socio
printType string Restringir a libros o revistas

Los valores aceptables son los siguientes:
  • "all": Todos los tipos de contenido de volumen.
  • "books": Solo libros.
  • "magazines": solo revistas.
projection string Restringe la información que se muestra a un conjunto de campos seleccionados.

Los valores aceptables son los siguientes:
  • "full": Incluye todos los datos del volumen.
  • "lite": Incluye un subconjunto de campos en volumeInfo y accessInfo.
showPreorders boolean Establécelo en verdadero a fin de mostrar los libros disponibles para pedir por adelantado. La configuración predeterminada es "false".
source string String para identificar el creador de esta solicitud.
startIndex unsigned integer Índice del primer resultado que se muestra (comienza en 0)

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud con este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
Nombre de propiedad Valor Descripción Notas
kind string Tipo de recurso.
items[] list Una lista de volúmenes.
totalItems integer Cantidad total de volúmenes encontrados. Esta cantidad puede ser mayor que la cantidad de volúmenes que se muestran en esta respuesta si los resultados se paginaron.

Pruébalo

Usa el siguiente explorador para llamar a este método en datos en vivo y ver la respuesta.