Volume: lista

Executa 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 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 Google e-books.
  • "free-ebooks": Google e-book com visibilidade de texto de volume total.
  • "full": o público pode ver o texto inteiro do volume.
  • "paid-ebooks": Google e-book com um preço.
  • "partial": o público consegue ver partes do texto.
langRestrict string Restringir os resultados a 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 Classificar os resultados da pesquisa.

Os valores aceitáveis são:
  • "newest": publicado mais recentemente.
  • "relevance": relevância em relação aos termos de pesquisa.
partner string Resultados de restrição e 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 Restringe 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 verdadeiro para mostrar os livros disponíveis para pré-encomenda. O padrão é "false".
source string String para identificar o criador desta 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 Observações
kind string Tipo de recurso.
items[] list Uma lista de volumes.
totalItems integer Número total de volumes encontrados. Isso pode ser maior que o número de volumes retornados nessa resposta se os resultados tiverem sido paginados.

Teste já!

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