Volume: lista

Realiza uma pesquisa de livros. Faça o teste agora.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros obrigatórios
q string String de consulta de pesquisa de texto completo.
Parâmetros opcionais
download string Restringir a volumes pela disponibilidade de download.

Os valores aceitáveis são:
  • "epub": todos os volumes com ePub.
filter string Filtrar os resultados da pesquisa.

Os valores aceitáveis são:
  • "ebooks" - todos os Google e-books.
  • "free-ebooks": e-book do Google com legibilidade de texto em volume total.
  • "full": o público pode acessar o texto completo do volume.
  • "paid-ebooks": e-book do Google com preço.
  • "partial": o público pode ver partes do texto.
langRestrict string Restringir os resultados a livros com este código de idioma.
libraryRestrict string Restringir a pesquisa à biblioteca desse usuário.

Os valores aceitáveis são:
  • "my-library": restringe à biblioteca do usuário, qualquer estante.
  • "no-restrict": não restringir com base na biblioteca do usuário.
maxResults unsigned integer Número máximo de resultados a serem retornados. Os valores aceitos vão de 0 a 40, inclusive.
orderBy string Classificar os resultados da pesquisa.

Os valores aceitáveis são:
  • "newest": o mais recente.
  • "relevance": relevância para os termos de pesquisa.
partner string Restringir e marcar os resultados do ID do parceiro.
printType string Restringir a livros ou revistas.

Os valores aceitáveis são:
  • "all": todos os tipos de conteúdo de volume.
  • "books": apenas livros.
  • "magazines": apenas revistas.
projection string Restringir informações retornadas a um conjunto de campos selecionados.

Os valores aceitáveis são:
  • "full": inclui todos os dados de volume.
  • "lite": inclui um subconjunto de campos em volumeInfo e accessInfo.
showPreorders boolean Defina como "true" para mostrar os livros disponíveis para pré-venda. O padrão é "false".
source string String para identificar o originador da solicitação.
startIndex unsigned integer Índice do primeiro resultado a ser retornado (começa em 0)

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se bem-sucedido, este método retornará um corpo de resposta com a seguinte estrutura:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
Nome da propriedade Valor Descrição Notas
kind string Tipo de recurso.
items[] list Uma lista de volumes.
totalItems integer Número total de volumes encontrados. Esse número pode ser maior do que o número de volumes retornados nesta resposta se os resultados foram paginados.

Teste já!

Use o explorador abaixo para chamar esse método em dados ativos e conferir a resposta.