Volume

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)

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)
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.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.
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.
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.pdf object Informações sobre o conteúdo em 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.
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).
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.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.