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 a 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
Executa 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 que estão disponíveis na projeção LITE são observados 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 Legenda 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 Editor deste volume. (Na projeção LITE.)
volumeInfo.publishedDate string Data de publicação. (Na 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 as tags b, i e br. (em projeção LITE)
volumeInfo.industryIdentifiers[] list São os 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 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 desse volume.
volumeInfo.dimensions.height string Altura ou comprimento deste volume (em cm).
volumeInfo.dimensions.width string É a largura deste volume (em cm).
volumeInfo.dimensions.thickness string Espessura desse volume (em cm).
volumeInfo.printType string Tipo de publicação deste volume. Os valores possíveis são LIVRO ou REVISTA.
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 do 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 Um identificador da versão do conteúdo do volume (texto e imagens). (Na projeção LITE)
volumeInfo.imageLinks.thumbnail string Link da imagem para o tamanho da miniatura (largura de cerca de 128 pixels). (em projeção LITE)
volumeInfo.imageLinks.small string Link da imagem para tamanho pequeno (largura de cerca de 300 pixels). (em projeção LITE)
volumeInfo.imageLinks.medium string Link da imagem para tamanho médio (largura de cerca de 575 pixels). (em projeção LITE)
volumeInfo.imageLinks.large string Link da imagem para tamanho grande (largura de cerca de 800 pixels). (em projeção LITE)
volumeInfo.imageLinks.smallThumbnail string Link da imagem para uma miniatura pequena (largura de cerca 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 esse 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 O comentário deste usuário sobre este 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 o volume foi comprado ou não 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 do país ISO_3166-1 de duas letras para o qual essa informação de venda é válida. (Na projeção LITE.)
saleInfo.saleability string 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. (Na projeção LITE.)
saleInfo.retailPrice object O preço de venda real do livro. É igual ao preço sugerido de varejo ou de tabela, a menos que existam 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 com três letras. (Na 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. (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. O valor PARTIAL significa que o editor permitiu que parte do volume fosse visualizada 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 um valor de ALL_PAGES.
accessInfo.epub object Informações sobre 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. (Na projeção LITE.)
accessInfo.embeddable boolean Indica se este volume pode ser incorporado em uma janela de visualização usando a API Embedded Viewer.
accessInfo.publicDomain boolean Se este livro é de domínio público no país listado acima.
userInfo.updated datetime Carimbo de data/hora em que este 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 redação de uma avaliação. (formato de data e hora RFC 3339 UTC).
userInfo.isPreordered boolean Se este volume foi ou não encomendado pelo usuário autenticado que fez a solicitação. (Na projeção LITE.)
saleInfo.onSaleDate datetime A data em que este livro estará disponível para venda.
accessInfo.textToSpeechPermission string Define 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 à licença de download de um volume.
accessInfo.downloadAccess.kind string Tipo de recurso.
accessInfo.downloadAccess.volumeId string Identifica o volume ao qual esta entrada se aplica.
accessInfo.downloadAccess.restricted boolean Indica se este volume tem alguma restrição de acesso a download.
accessInfo.downloadAccess.deviceAllowed boolean Se restrito, se o acesso é concedido para isso (usuário, dispositivo, volume).
accessInfo.downloadAccess.justAcquired boolean Se deviceAllowed, se o acesso foi 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 este 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 a download e validação do cliente.
accessInfo.downloadAccess.source string É o identificador do app cliente para verificação. Somente acesso a 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 Informações dos resultados da pesquisa relacionadas a este volume.
searchInfo.textSnippet string Um snippet de texto que contém a consulta de pesquisa.