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 Es la cadena de consulta de búsqueda en el texto completo.
Parámetros opcionales
download string Restringir a volúmenes según la disponibilidad de descarga.

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

Los valores aceptables son los siguientes:
  • "ebooks": Todos los libros electrónicos de Google.
  • "free-ebooks": Libro electrónico de Google con visibilidad de texto a volumen completo.
  • "full": El público puede ver todo el texto del volumen.
  • "paid-ebooks": Libro electrónico de Google con un precio.
  • "partial": El público puede ver partes del texto.
langRestrict string Restringe los resultados a los libros con este código de idioma.
libraryRestrict string Restringe la búsqueda a la biblioteca de este usuario.

Los valores aceptables son los siguientes:
  • "my-library": Restringe la biblioteca del usuario, cualquier biblioteca.
  • "no-restrict": No restrinjas 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 Ordena los resultados de la búsqueda.

Los valores aceptables son los siguientes:
  • "newest": Es la publicación más reciente.
  • "relevance": Relevancia con los términos de búsqueda.
partner string Restringe y marca los resultados del ID de socio.
printType string Limitar 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 devuelve a un conjunto de campos seleccionados.

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

Cuerpo de la solicitud

No proporciones un cuerpo de la 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 la 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. Si los resultados se paginaron, esta cantidad puede ser mayor que la cantidad de volúmenes que se muestran en esta respuesta.

Pruébalo

Usa el explorador que aparece a continuación para llamar a este método en los datos en tiempo real y ver la respuesta.