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 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": Google libro electrónico con visibilidad de texto de volumen total.
  • "full": El público puede ver todo el texto del volumen.
  • "paid-ebooks": Google libro electrónico 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 Restringir la búsqueda a la biblioteca de este usuario.

Los valores aceptables son los siguientes:
  • "my-library": Se restringe a cualquier biblioteca del usuario o a cualquier biblioteca.
  • "no-restrict": No se restringe 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": Se publicó la última vez.
  • "relevance": La relevancia para los términos de búsqueda.
partner string Restricción y resultados de marca para el 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 muestra 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 Si la estableces como verdadera, se mostrarán los libros disponibles para pedir por adelantado. La configuración predeterminada es "false".
source string Cadena para identificar al originador 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. Puede ser mayor que la cantidad de volúmenes mostrados en esta respuesta si los resultados se paginaron.

Pruébalo

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