Uma coleção
Volume
é usada para realizar uma pesquisa ou listar o conteúdo de uma estante. Esta coleção é apenas para leitura.Métodos
Os métodos a seguir se aplicam aos dados públicos sobre volumes e não exigem autenticação.
books.volumes.list (link em inglês)books.volumes.get (link em inglês)
O método a seguir se aplica à visualização particular de "Minha biblioteca" de volumes e requer autenticação.
books.mylibrary.bookshwards.volumes.list (link em inglês)books.bookshel.volumes.list (em inglês)
- get
- Recupera um recurso de volume com base no ID.
- list
- Executa uma pesquisa sobre livros.
Representações de recursos
Um volume representa as informações que o Google Livros hospeda sobre um livro ou uma revista. Ela contém metadados, como título e autor, além de dados personalizados, por exemplo, a compra ou não. Os campos de volume disponíveis na projeção LITE são indicados abaixo.
{ "kind": "books#volume", "id": string, "etag": string, "selfLink": string, "volumeInfo": { "title": string, "subtitle": string, "authors": [ string ], "publisher": string, "publishedDate": string, "description": string, "industryIdentifiers": [ { "type": string, "identifier": string } ], "pageCount": integer, "dimensions": { "height": string, "width": string, "thickness": string }, "printType": string, "mainCategory": string, "categories": [ string ], "averageRating": double, "ratingsCount": integer, "contentVersion": string, "imageLinks": { "smallThumbnail": string, "thumbnail": string, "small": string, "medium": string, "large": string, "extraLarge": string }, "language": string, "previewLink": string, "infoLink": string, "canonicalVolumeLink": string }, "userInfo": { "review": mylibrary.reviews Resource, "readingPosition": mylibrary.readingpositions Resource, "isPurchased": boolean, "isPreordered": boolean, "updated": datetime }, "saleInfo": { "country": string, "saleability": string, "onSaleDate": datetime, "isEbook": boolean, "listPrice": { "amount": double, "currencyCode": string }, "retailPrice": { "amount": double, "currencyCode": string }, "buyLink": string }, "accessInfo": { "country": string, "viewability": string, "embeddable": boolean, "publicDomain": boolean, "textToSpeechPermission": string, "epub": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "pdf": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "webReaderLink": string, "accessViewStatus": string, "downloadAccess": { "kind": "books#downloadAccessRestriction", "volumeId": string, "restricted": boolean, "deviceAllowed": boolean, "justAcquired": boolean, "maxDownloadDevices": integer, "downloadsAcquired": integer, "nonce": string, "source": string, "reasonCode": string, "message": string, "signature": string } }, "searchInfo": { "textSnippet": string } }
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
kind |
string |
Tipo de recurso para um volume. Na projeção LITE. | |
id |
string |
Identificador exclusivo de um volume. Na projeção LITE. | |
etag |
string |
Identificador opaco de uma versão específica de um recurso de volume. (na projeção LITE) | |
selfLink |
string |
URL para este recurso. Na projeção LITE. | |
volumeInfo |
object |
Informações gerais sobre o volume. | |
volumeInfo.title |
string |
Título do volume. Na projeção LITE. | |
volumeInfo.subtitle |
string |
Subtítulo do volume. Na projeção LITE. | |
volumeInfo.authors[] |
list |
Os nomes dos autores e/ou editores deste volume. (na projeção LITE) | |
volumeInfo.publisher |
string |
É o editor desse volume. Na projeção LITE. | |
volumeInfo.publishedDate |
string |
Data de publicação. Na projeção LITE. | |
volumeInfo.description |
string |
Um resumo do volume. O texto da descrição é formatado em HTML e inclui elementos de formatação simples, como as tags b, i e br. (na projeção LITE) | |
volumeInfo.industryIdentifiers[] |
list |
Identificadores padrão do setor para esse volume. | |
volumeInfo.industryIdentifiers[].type |
string |
Tipo de identificador. Os valores possíveis são ISBN_10, ISBN_13, ISSN e OTHER. | |
volumeInfo.industryIdentifiers[].identifier |
string |
Identificador de volume específico do setor. | |
volumeInfo.pageCount |
integer |
Número total de páginas. | |
volumeInfo.dimensions |
object |
Dimensões físicas deste volume. | |
volumeInfo.dimensions.height |
string |
Altura ou comprimento desse volume (em cm). | |
volumeInfo.dimensions.width |
string |
Largura desse volume (em cm). | |
volumeInfo.dimensions.thickness |
string |
Espessura desse volume (em cm). | |
volumeInfo.printType |
string |
Tipo de publicação desse volume. Os valores possíveis são BOOK ou MAGAZINE. | |
volumeInfo.categories[] |
list |
Uma lista de categorias de assunto, como "Ficção", "Suspense" etc. | |
volumeInfo.averageRating |
double |
A classificação média da avaliação para esse volume. (mín. = 1.0, máx. = 5.0) | |
volumeInfo.ratingsCount |
integer |
O número de classificações de avaliação para este volume. | |
volumeInfo.contentVersion |
string |
Identificador para a versão do conteúdo de volume (texto e imagens). (na projeção LITE) | |
volumeInfo.imageLinks |
object |
Uma lista de links de imagens para todos os tamanhos disponíveis. (na projeção LITE) | |
volumeInfo.imageLinks.thumbnail |
string |
Link da imagem para o tamanho da miniatura (largura de aproximadamente 128 pixels). (na projeção LITE) | |
volumeInfo.imageLinks.small |
string |
Link da imagem para tamanho pequeno (largura de aproximadamente 300 pixels). (na projeção LITE) | |
volumeInfo.imageLinks.medium |
string |
Link da imagem para tamanho médio (largura de aproximadamente 575 pixels). (na projeção LITE) | |
volumeInfo.imageLinks.large |
string |
Link da imagem para tamanho grande (largura de aproximadamente 800 pixels). (na projeção LITE) | |
volumeInfo.imageLinks.smallThumbnail |
string |
Link da imagem para miniatura pequena (largura de aproximadamente 80 pixels). (na projeção LITE) | |
volumeInfo.imageLinks.extraLarge |
string |
Link da imagem para tamanho extra grande (largura de aproximadamente 1.280 pixels). (na projeção LITE) | |
volumeInfo.language |
string |
Melhor idioma para este volume (com base no conteúdo). É o código ISO 639-1 de duas letras, como "fr", "en" etc. | |
volumeInfo.mainCategory |
string |
A categoria principal à qual o volume pertence. Será a categoria da lista de categorias retornada abaixo que tem a ponderação mais alta. | |
volumeInfo.previewLink |
string |
URL para visualizar este volume no site do Google Livros. | |
userInfo |
object |
São as informações específicas do usuário relacionadas a este volume. (por exemplo, a página que o usuário leu ou se comprou o livro) | |
userInfo.review |
nested object |
A avaliação do usuário para esse volume, se houver. | |
userInfo.readingPosition |
readingPosition Resource |
A posição de leitura atual do usuário no volume, se houver. Na projeção LITE. | |
userInfo.isPurchased |
boolean |
Se este volume foi comprado pelo usuário autenticado que fez a solicitação. Na projeção LITE. | |
saleInfo |
object |
Qualquer informação sobre um volume relacionado à loja de e-books e/ou à possibilidade de compra. Essas informações podem depender do país de origem da solicitação (ou seja, os livros podem não estar à venda em determinados países). | |
saleInfo.country |
string |
O código de país ISO_3166-1 de duas letras em que as informações de venda são válidas. Na projeção LITE. | |
saleInfo.saleability |
string |
Se o livro está disponível para venda ou é oferecido sem custo financeiro na Google eBookstore no país listado acima. Os valores possíveis são FOR_SALE, SEM CUSTO FINANCEIRO, NOT_FOR_SALE ou FOR_PREORDER. | |
saleInfo.isEbook |
boolean |
Se esse volume é ou não um e-book (pode ser adicionado à estante "Meus e-books"). | |
saleInfo.listPrice |
object |
Preço de varejo sugerido. (na projeção LITE) | |
saleInfo.listPrice.amount |
double |
Valor na moeda listada abaixo. Na projeção LITE. | |
saleInfo.listPrice.currencyCode |
string |
Um código de moeda ISO 4217 com três letras. Na projeção LITE. | |
saleInfo.retailPrice |
object |
É o preço real de venda do livro. Ele é igual ao preço de varejo ou da lista sugerido, a menos que haja ofertas ou descontos nesse volume. (na projeção LITE) | |
saleInfo.retailPrice.amount |
double |
Valor na moeda listada abaixo. Na projeção LITE. | |
saleInfo.retailPrice.currencyCode |
string |
Um código de moeda ISO 4217 com três letras. Na projeção LITE. | |
saleInfo.buyLink |
string |
URL para comprar este volume no site do Google Livros. (na projeção LITE) | |
accessInfo |
object |
Qualquer informação sobre um volume relacionado à leitura ou à busca do texto desse volume. Essa informação depende do país. Os livros podem ser de domínio público em um país, mas não em outro, por exemplo. | |
accessInfo.country |
string |
O código de país ISO_3166-1 de duas letras para o qual essas informações de acesso são válidas. Na projeção LITE. | |
accessInfo.viewability |
string |
O acesso de leitura de um volume. Os valores possíveis são PARTIAL, ALL_PAGES, NO_PAGES ou UNKNOWN. Esse valor depende do país listado acima. Um valor PARCIAL significa que o editor permitiu que parte do volume fosse visualizada publicamente, sem compra. Isso se aplica tanto a e-books quanto a e-books. Os livros de domínio público sempre terão um valor de ALL_PAGES. | |
accessInfo.epub |
object |
Informações sobre o conteúdo do EPUB. (na projeção LITE) | |
accessInfo.epub.downloadLink |
string |
URL para fazer o download do EPUB. Na projeção LITE. | |
accessInfo.epub.acsTokenLink |
string |
URL para recuperar o token ACS para download do epub. Na projeção LITE. | |
accessInfo.pdf |
object |
Informações sobre o conteúdo em PDF. (na projeção LITE) | |
accessInfo.pdf.downloadLink |
string |
URL para fazer o download do PDF. Na projeção LITE. | |
accessInfo.pdf.acsTokenLink |
string |
URL para recuperar o token ACS para download de PDF. Na projeção LITE. | |
accessInfo.accessViewStatus |
string |
Combina o acesso e a visibilidade desse volume em um único campo de status para esse usuário. Os valores podem ser FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE ou NONE. Na projeção LITE. | |
accessInfo.embeddable |
boolean |
Indica se esse volume pode ser incorporado a uma janela de visualização usando a API Embedded Viewer. | |
accessInfo.publicDomain |
boolean |
Indica se o livro é de domínio público no país listado acima. | |
|
string |
URL para ver informações sobre esse volume no site do Google Livros. (na projeção LITE) | |
userInfo.updated |
datetime |
É o carimbo de data/hora em que esse volume foi modificado pela última vez por uma ação do usuário, como uma atualização da posição de leitura, compra de volume ou avaliação. (formato de data e hora UTC RFC 3339). | |
volumeInfo.canonicalVolumeLink |
string |
URL canônico para um volume. Na projeção LITE. | |
userInfo.isPreordered |
boolean |
Se este volume foi encomendado pelo usuário autenticado que fez a solicitação ou não. Na projeção LITE. | |
saleInfo.onSaleDate |
datetime |
É a data em que o livro estará disponível para venda. | |
accessInfo.textToSpeechPermission |
string |
Se a conversão de texto em voz é permitida para este volume. Os valores podem ser ALLOWED, ALLOWED_FOR_ACCESSIBILITY ou NOT_ALLOWED. | |
accessInfo.epub.isAvailable |
boolean |
É um EPUB de texto corrido disponível como domínio público ou para compra. Na projeção LITE. | |
accessInfo.pdf.isAvailable |
boolean |
É um PDF de imagem digitalizada disponível como domínio público ou para compra. Na projeção LITE. | |
accessInfo.webReaderLink |
string |
URL para ler este volume no site do Google Livros. O link não permite que os usuários leiam volumes não visíveis. | |
accessInfo.downloadAccess |
nested object |
Informações sobre as restrições de acesso a licenças de download de um volume. | |
accessInfo.downloadAccess.kind |
string |
Tipo de recurso. | |
accessInfo.downloadAccess.volumeId |
string |
Identifica o volume a que essa entrada se aplica. | |
accessInfo.downloadAccess.restricted |
boolean |
Indica se este volume tem restrições de acesso a downloads. | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
Se for restrito, se o acesso será concedido para isso (usuário, dispositivo, volume). | |
accessInfo.downloadAccess.justAcquired |
boolean |
Se deviceAllowed, o acesso foi adquirido com esta solicitação. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
Se for restrito, o número máximo de licenças de download de conteúdo para este volume. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
Se for restrito, o número de licenças de download de conteúdo já adquiridas, incluindo o cliente solicitante, se licenciado. | |
accessInfo.downloadAccess.nonce |
string |
Valor de uso único do cliente para verificação. Somente para download e validação do cliente. | |
accessInfo.downloadAccess.source |
string |
Identificador do app cliente para verificação. Somente para download e validação do cliente. | |
accessInfo.downloadAccess.reasonCode |
string |
Código do motivo do erro/aviso. Outros códigos poderão ser adicionados no futuro. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS | |
accessInfo.downloadAccess.message |
string |
Mensagem de erro/aviso. | |
accessInfo.downloadAccess.signature |
string |
Assinatura da resposta. | |
searchInfo |
object |
São as informações dos resultados da pesquisa relacionadas a este volume. | |
searchInfo.textSnippet |
string |
Um snippet de texto que contém a consulta de pesquisa. |