Volumen: lista
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-11-08 (UTC)
[null,null,["Última actualización: 2024-11-08 (UTC)"],[[["\u003cp\u003eSearches for books based on a provided query string.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by criteria such as availability, format, language, and publication type.\u003c/p\u003e\n"],["\u003cp\u003eOffers control over the number of results, sorting order, and specific data fields returned.\u003c/p\u003e\n"],["\u003cp\u003eCan be used to retrieve information about books, including volume details and access options.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to handle large result sets.\u003c/p\u003e\n"]]],[],null,["# Volume: list\n\nPerforms a book search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n GET https://www.googleapis.com/books/v1/volumes?q={search terms}\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-------------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `q` | `string` | Full-text search query string. |\n| **Optional Parameters** |||\n| `download` | `string` | Restrict to volumes by download availability. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`epub`\" - All volumes with epub. |\n| `filter` | `string` | Filter search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`ebooks`\" - All Google eBooks. - \"`free-ebooks`\" - Google eBook with full volume text viewability. - \"`full`\" - Public can view entire volume text. - \"`paid-ebooks`\" - Google eBook with a price. - \"`partial`\" - Public able to see parts of text. |\n| `langRestrict` | `string` | Restrict results to books with this language code. |\n| `libraryRestrict` | `string` | Restrict search to this user's library. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`my-library`\" - Restrict to the user's library, any shelf. - \"`no-restrict`\" - Do not restrict based on user's library. |\n| `maxResults` | `unsigned integer` | Maximum number of results to return. Acceptable values are `0` to `40`, inclusive. |\n| `orderBy` | `string` | Sort search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`newest`\" - Most recently published. - \"`relevance`\" - Relevance to search terms. |\n| `partner` | `string` | Restrict and brand results for partner ID. |\n| `printType` | `string` | Restrict to books or magazines. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\" - All volume content types. - \"`books`\" - Just books. - \"`magazines`\" - Just magazines. |\n| `projection` | `string` | Restrict information returned to a set of selected fields. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`full`\" - Includes all volume data. - \"`lite`\" - Includes a subset of fields in volumeInfo and accessInfo. |\n| `showPreorders` | `boolean` | Set to true to show books available for preorder. Defaults to false. |\n| `source` | `string` | String to identify the originator of this request. |\n| `startIndex` | `unsigned integer` | Index of the first result to return (starts at 0) |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n {\n \"kind\": \"books#volumes\",\n \"items\": [\n volume Resource\n ],\n \"totalItems\": (value)\n }\n\n| Property Name | Value | Description | Notes |\n|---------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `items[]` | `list` | A list of volumes. | |\n| `totalItems` | `integer` | Total number of volumes found. This might be greater than the number of volumes returned in this response if results have been paginated. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]
