Volume: list

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 aos volumes por disponibilidade de download.

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

Os valores aceitáveis são:
  • "ebooks": todos os e-books do Google.
  • "free-ebooks": e-book do Google com visibilidade total do texto.
  • "full": o público pode ver o texto do volume inteiro.
  • "paid-ebooks": e-book do Google com um preço.
  • "partial": o público vê partes do texto.
langRestrict string Restrinja os resultados para livros com este código de idioma.
libraryRestrict string Restringir a pesquisa à biblioteca deste 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 aceitáveis são de 0 a 40, inclusive.
orderBy string Ordenar resultados de pesquisa.

Os valores aceitáveis são:
  • "newest": publicado mais recentemente.
  • "relevance": relevância dos termos de pesquisa.
partner string Restringir e gerar resultados de marca para o 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": somente livros.
  • "magazines": somente revistas.
projection string Restrinja as 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 ver os livros disponíveis para pré-venda. O padrão é "false".
source string String para identificar o criador 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 for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
Nome da propriedade Valor Descrição Observações
kind string Tipo de recurso.
items[] list Uma lista de volumes.
totalItems integer Número total de volumes encontrados. Isso poderá ser maior que o número de volumes retornados nessa resposta se os resultados tiverem sido paginados.

Faça o teste!

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