Volume

Uma coleção Volume é usada para realizar uma pesquisa ou listar o conteúdo de uma estante. Esta coleção é somente 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
books.volumes.get

O método a seguir se aplica à visualização de volumes particular "Minha biblioteca" e requer autenticação.
books.mylibrary.bookshelves.volumes.list

get
Recupera um recurso de volume com base no ID.
list
Realiza uma pesquisa de livros.

Representações de recursos

Um volume representa informações que o Google Livros hospeda sobre um livro ou uma revista. Ele contém metadados, como título e autor, bem como dados personalizados, por exemplo, se foi ou não comprado. Os campos de volume disponíveis na projeção LITE estã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 de um volume. (Em projeção LITE.)
id string Identificador exclusivo de um volume. (Em projeção LITE.)
etag string Identificador opaco para uma versão específica de um recurso de volume. (Em projeção LITE)
volumeInfo object Informações gerais sobre o volume.
volumeInfo.title string Título do volume. (Em projeção LITE.)
volumeInfo.subtitle string Subtítulo do volume. (Na projeção LITE.)
volumeInfo.authors[] list Os nomes dos autores e/ou editores do volume. (Em projeção LITE)
volumeInfo.publisher string Editor deste volume. (Em projeção LITE.)
volumeInfo.publishedDate string Data de publicação. (Em projeção LITE.)
volumeInfo.description string Uma sinopse do volume. O texto da descrição é formatado em HTML e inclui elementos de formatação simples, como tags b, i e br. (em projeção LITE)
volumeInfo.industryIdentifiers[] list Identificadores padrão do setor para este volume.
volumeInfo.industryIdentifiers[].type string Tipo de identificador. Os valores possíveis são ISBN_10, ISBN_13, ISSN e OUTRO.
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 do volume (em cm).
volumeInfo.dimensions.width string Largura do volume (em cm).
volumeInfo.dimensions.thickness string Espessura do volume (em cm).
volumeInfo.printType string Tipo de publicação deste volume. Os valores possíveis são BOOK ou MAGAZINE.
volumeInfo.categories[] list Uma lista de categorias de assuntos, como "Ficção", "Suspense" etc.
volumeInfo.averageRating double A classificação média da avaliação para este volume. (mínimo = 1,0, máximo = 5,0)
volumeInfo.ratingsCount integer O número de classificações de avaliação para este volume.
volumeInfo.contentVersion string Um identificador da versão do conteúdo do volume (texto e imagens). (Em projeção LITE)
volumeInfo.imageLinks.thumbnail string Link da imagem para o tamanho da miniatura (largura de ~128 pixels). (em projeção LITE)
volumeInfo.imageLinks.small string Link da imagem para tamanho pequeno (largura de ~300 pixels). (em projeção LITE)
volumeInfo.imageLinks.medium string Link da imagem para tamanho médio (largura de ~575 pixels). (em projeção LITE)
volumeInfo.imageLinks.large string Link da imagem para tamanho grande (largura de aproximadamente 800 pixels). (em projeção LITE)
volumeInfo.imageLinks.smallThumbnail string Link da imagem para miniatura pequena (largura de ~80 pixels). (em projeção LITE)
volumeInfo.imageLinks.extraLarge string Link da imagem para tamanho extra grande (largura de cerca de 1.280 pixels). (em 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 a que este volume pertence. Será a categoria da lista de categorias mostrada abaixo que tiver o maior peso.
userInfo object Informações específicas do usuário relacionadas a este volume. (por exemplo, a página que o usuário leu pela última vez ou se ele comprou o livro)
userInfo.review nested object A avaliação do usuário sobre o volume, se houver.
userInfo.readingPosition readingPosition Resource A posição de leitura atual do usuário no volume, se disponível. (Na projeção LITE.)
userInfo.isPurchased boolean Indica se o volume foi comprado pelo usuário autenticado que fez a solicitação. (Em projeção LITE.)
saleInfo object Qualquer informação sobre um volume relacionado à livraria de e-books e/ou à capacidade de compra. Essas informações podem depender do país de origem da solicitação. Por exemplo, os livros podem não estar disponíveis para venda em determinados países.
saleInfo.country string O código de país ISO_3166-1 de duas letras para o qual as informações de venda são válidas. (Na projeção LITE.)
saleInfo.saleability string Indica se o livro está disponível para venda ou oferecido sem custo financeiro na Google eBookstore para o país listado acima. Os valores possíveis são FOR_SALE, FREE, NOT_FOR_SALE ou FOR_PREORDER.
saleInfo.isEbook boolean Se este volume é ou não um e-book (pode ser adicionado à prateleira Meus e-books).
saleInfo.listPrice object Preço de varejo sugerido. (em 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. (Em projeção LITE.)
saleInfo.retailPrice object O preço de venda real do livro. Esse valor é igual ao preço de varejo sugerido ou de tabela, a menos que haja ofertas ou descontos nesse volume. (em 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 de três letras. (Em projeção LITE.)
accessInfo object Qualquer informação sobre um volume relacionada à leitura ou obtenção do texto de volume. Essas informações podem depender do país. Por exemplo, os livros podem ser de domínio público em um país, mas não em outro.
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. (Em 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 de PARTIAL significa que o editor permitiu que parte do volume fosse visualizado publicamente, sem compra. Isso pode se aplicar a e-books e não e-books. Os livros de domínio público sempre terão o valor ALL_PAGES.
accessInfo.epub object Informações sobre o conteúdo EPUB. (em projeção LITE)
accessInfo.pdf object Informações sobre o conteúdo em PDF. (em projeção LITE)
accessInfo.accessViewStatus string Combina o acesso e a visibilidade desse volume em um único campo de status para o usuário. Os valores podem ser FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE ou NONE. (Em projeção LITE.)
accessInfo.embeddable boolean Indica se esse volume pode ser incorporado em uma janela de visualização usando a API Embedded Viewer.
accessInfo.publicDomain boolean Se o livro é de domínio público no país listado acima.
userInfo.updated datetime Carimbo de data/hora da última modificação desse volume por uma ação do usuário, como uma atualização da posição de leitura, compra de volume ou escrita de uma avaliação. (formato de data/hora UTC RFC 3339).
userInfo.isPreordered boolean Se o volume foi encomendado antecipadamente pelo usuário autenticado que fez a solicitação. (Em projeção LITE.)
saleInfo.onSaleDate datetime A data em que o livro vai estar disponível para venda.
accessInfo.textToSpeechPermission string Indica 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. (Em projeção LITE.)
accessInfo.pdf.isAvailable boolean É um PDF de imagem digitalizada disponível como domínio público ou para compra. (Em projeção LITE.)
accessInfo.downloadAccess nested object Informações sobre as restrições de acesso à licença de download de um volume.
accessInfo.downloadAccess.kind string Tipo de recurso.
accessInfo.downloadAccess.volumeId string Identifica o volume a que esta entrada se aplica.
accessInfo.downloadAccess.restricted boolean Se esse volume tem restrições de acesso para download.
accessInfo.downloadAccess.deviceAllowed boolean Se restrito, se o acesso foi concedido para isso (usuário, dispositivo, volume).
accessInfo.downloadAccess.justAcquired boolean Se deviceAllowed, se o acesso acabou de ser adquirido com essa solicitação.
accessInfo.downloadAccess.maxDownloadDevices integer Se restrito, o número máximo de licenças de download de conteúdo para esse volume.
accessInfo.downloadAccess.downloadsAcquired integer Se 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 acesso para download e validação do cliente.
accessInfo.downloadAccess.source string Identificador do app cliente para verificação. Somente acesso para download e validação do cliente.
accessInfo.downloadAccess.reasonCode string Código do motivo do erro/aviso. Outros códigos podem 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 Informações do resultado da pesquisa relacionadas a esse volume.
searchInfo.textSnippet string Um snippet de texto que contém a consulta de pesquisa.