Volume

Koleksi Volume digunakan untuk melakukan penelusuran atau mencantumkan konten rak buku. Koleksi ini adalah koleksi hanya baca.

Metode

Metode berikut berlaku untuk data publik tentang volume dan tidak memerlukan autentikasi.
books.volumes.list
books.volumes.get

Metode berikut berlaku untuk tampilan volume "Koleksi Saya" pribadi dan memerlukan autentikasi.
books.mylibrary.bookshelves.volumes.list

dapatkan
Mengambil Resource volume berdasarkan ID.
list
Melakukan penelusuran buku.

Representasi Resource

Volume mewakili informasi yang dihosting Google Buku tentang buku atau majalah. Item baris ini berisi metadata, seperti judul dan pengarang, serta data yang dipersonalisasi, seperti apakah buku tersebut telah dibeli atau belum. (Kolom volume yang tersedia di proyeksi LITE tercantum di bawah).

{
  "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
  }
}
Nama Properti Nilai Deskripsi Catatan
kind string Jenis resource untuk volume. (Dalam proyeksi LITE.)
id string ID unik untuk volume. (Dalam proyeksi LITE.)
etag string ID buram untuk versi resource volume tertentu. (Dalam proyeksi LITE)
volumeInfo object Informasi volume umum.
volumeInfo.title string Judul volume. (Dalam proyeksi LITE.)
volumeInfo.subtitle string Subjudul volume. (Dalam proyeksi LITE.)
volumeInfo.authors[] list Nama penulis dan/atau editor untuk volume ini. (Dalam proyeksi LITE)
volumeInfo.publisher string Penerbit volume ini. (Dalam proyeksi LITE.)
volumeInfo.publishedDate string Tanggal publikasi. (Dalam proyeksi LITE.)
volumeInfo.description string Sinopsis volume. Teks deskripsi diformat dalam HTML dan menyertakan elemen pemformatan sederhana, seperti tag b, i, dan br. (dalam proyeksi LITE)
volumeInfo.industryIdentifiers[] list ID standar industri untuk volume ini.
volumeInfo.industryIdentifiers[].type string Jenis ID. Nilai yang mungkin adalah ISBN_10, ISBN_13, ISSN, dan OTHER.
volumeInfo.industryIdentifiers[].identifier string ID volume khusus industri.
volumeInfo.pageCount integer Jumlah total halaman.
volumeInfo.dimensions object Dimensi fisik volume ini.
volumeInfo.dimensions.height string Tinggi atau panjang volume ini (dalam cm).
volumeInfo.dimensions.width string Lebar volume ini (dalam cm).
volumeInfo.dimensions.thickness string Ketebalan volume ini (dalam cm).
volumeInfo.printType string Jenis publikasi volume ini. Nilai yang mungkin adalah BOOK atau MAGAZINE.
volumeInfo.categories[] list Daftar kategori subjek, seperti "Fiksi", "Suspense", dll.
volumeInfo.averageRating double Rating ulasan rata-rata untuk volume ini. (min = 1,0, maks = 5,0)
volumeInfo.ratingsCount integer Jumlah rating ulasan untuk volume ini.
volumeInfo.contentVersion string ID untuk versi konten volume (teks & amp; gambar). (Dalam proyeksi LITE)
volumeInfo.imageLinks.thumbnail string Link gambar untuk ukuran thumbnail (lebar ~128 piksel). (dalam proyeksi LITE)
volumeInfo.imageLinks.small string Link gambar untuk ukuran kecil (lebar ~300 piksel). (dalam proyeksi LITE)
volumeInfo.imageLinks.medium string Link gambar untuk ukuran sedang (lebar ~575 piksel). (dalam proyeksi LITE)
volumeInfo.imageLinks.large string Link gambar untuk ukuran besar (lebar ~800 piksel). (dalam proyeksi LITE)
volumeInfo.imageLinks.smallThumbnail string Link gambar untuk ukuran thumbnail kecil (lebar ~80 piksel). (dalam proyeksi LITE)
volumeInfo.imageLinks.extraLarge string Link gambar untuk ukuran ekstra besar (lebar ~1280 piksel). (dalam proyeksi LITE)
volumeInfo.language string Bahasa terbaik untuk volume ini (berdasarkan konten). Kode ini adalah kode ISO 639-1 dua huruf seperti 'fr', 'en', dll.
volumeInfo.mainCategory string Kategori utama yang mencakup volume ini. Ini akan menjadi kategori dari daftar kategori yang ditampilkan di bawah yang memiliki bobot tertinggi.
userInfo object Informasi spesifik per pengguna yang terkait dengan volume ini. (misalnya, halaman yang terakhir dibaca pengguna ini atau apakah mereka membeli buku ini)
userInfo.review nested object Ulasan pengguna ini tentang volume ini, jika ada.
userInfo.readingPosition readingPosition Resource Posisi membaca pengguna saat ini dalam volume, jika tersedia. (Dalam proyeksi LITE.)
userInfo.isPurchased boolean Apakah volume ini dibeli oleh pengguna terautentikasi yang membuat permintaan. (Dalam proyeksi LITE.)
saleInfo object Informasi apa pun tentang volume yang terkait dengan eBookstore dan/atau pembelian. Informasi ini dapat bergantung pada negara tempat permintaan berasal (yaitu buku mungkin tidak dijual di negara tertentu).
saleInfo.country string Kode negara ISO_3166-1 dua huruf yang valid untuk informasi penjualan ini. (Dalam proyeksi LITE.)
saleInfo.saleability string Apakah buku ini tersedia untuk dijual atau ditawarkan secara gratis di Google eBookstore untuk negara yang tercantum di atas. Nilai yang dapat digunakan adalah FOR_SALE, GRATIS, NOT_FOR_SALE, atau FOR_PREORDER.
saleInfo.isEbook boolean Apakah volume ini merupakan eBook atau tidak (dapat ditambahkan ke galeri eBook Saya).
saleInfo.listPrice object Harga retail yang disarankan. (dalam proyeksi LITE)
saleInfo.listPrice.amount double Jumlah dalam mata uang yang tercantum di bawah. (Dalam proyeksi LITE.)
saleInfo.listPrice.currencyCode string Kode mata uang tiga huruf ISO 4217. (Dalam proyeksi LITE.)
saleInfo.retailPrice object Harga jual buku yang sebenarnya. Harga ini sama dengan harga retail atau harga yang disarankan kecuali jika ada penawaran atau diskon untuk volume ini. (dalam proyeksi LITE)
saleInfo.retailPrice.amount double Jumlah dalam mata uang yang tercantum di bawah. (Dalam proyeksi LITE.)
saleInfo.retailPrice.currencyCode string Kode mata uang tiga huruf ISO 4217. (Dalam proyeksi LITE.)
accessInfo object Informasi apa pun tentang volume yang terkait dengan pembacaan atau perolehan teks volume tersebut. Informasi ini dapat bergantung pada negara (buku dapat berada di domain publik di satu negara tetapi tidak di negara lainnya, mis.).
accessInfo.country string Kode negara dua huruf ISO_3166-1 yang informasi aksesnya valid. (Dalam proyeksi LITE.)
accessInfo.viewability string Akses baca volume. Nilai yang mungkin adalah PARTIAL, ALL_PAGES, NO_PAGES atau UNKNOWN. Nilai ini bergantung pada negara yang tercantum di atas. Nilai PARTIAL berarti penayang telah mengizinkan sebagian volume untuk dilihat secara publik, tanpa pembelian. Ini dapat berlaku untuk eBook dan non-eBook. Buku domain publik akan selalu memiliki nilai ALL_PAGES.
accessInfo.epub object Informasi tentang konten epub. (dalam proyeksi LITE)
accessInfo.pdf object Informasi tentang konten pdf. (dalam proyeksi LITE)
accessInfo.accessViewStatus string Menggabungkan akses dan visibilitas volume ini ke dalam satu kolom status untuk pengguna ini. Nilai dapat berupa FULL_PURCHASED, FULL_Public_DOMAIN, SAMPLE, atau NONE. (Dalam proyeksi LITE.)
accessInfo.embeddable boolean Apakah volume ini dapat disematkan di area pandang menggunakan Embedded Viewer API.
accessInfo.publicDomain boolean Apakah buku ini merupakan domain publik di negara yang tercantum di atas.
userInfo.updated datetime Stempel waktu saat volume ini terakhir diubah oleh tindakan pengguna, seperti pembaruan posisi membaca, pembelian volume, atau menulis ulasan. (Format waktu dan tanggal RFC 3339 UTC).
userInfo.isPreordered boolean Apakah volume ini dipraorder oleh pengguna terautentikasi yang membuat permintaan. (Dalam proyeksi LITE.)
saleInfo.onSaleDate datetime Tanggal buku ini tersedia untuk dijual.
accessInfo.textToSpeechPermission string Apakah text-to-speech diizinkan untuk volume ini. Nilai dapat DIIZINKAN, ALLOW_FOR_ACCESSIBILITY, atau NOT_PERMISSION.
accessInfo.epub.isAvailable boolean Apakah epub teks mengalir tersedia sebagai domain publik atau untuk dibeli. (Dalam proyeksi LITE.)
accessInfo.pdf.isAvailable boolean Apakah PDF gambar yang dipindai tersedia sebagai domain publik atau untuk dibeli. (Dalam proyeksi LITE.)
accessInfo.downloadAccess nested object Informasi tentang pembatasan akses lisensi download volume.
accessInfo.downloadAccess.kind string Jenis resource.
accessInfo.downloadAccess.volumeId string Mengidentifikasi volume yang diterapkan untuk entri ini.
accessInfo.downloadAccess.restricted boolean Apakah volume ini memiliki batasan akses download.
accessInfo.downloadAccess.deviceAllowed boolean Jika dibatasi, apakah akses diberikan untuk pengguna ini (pengguna, perangkat, volume).
accessInfo.downloadAccess.justAcquired boolean Jika deviceAllowed, apakah akses hanya diperoleh dengan permintaan ini.
accessInfo.downloadAccess.maxDownloadDevices integer Jika dibatasi, jumlah maksimum lisensi download konten untuk volume ini.
accessInfo.downloadAccess.downloadsAcquired integer Jika dibatasi, jumlah lisensi download konten sudah diperoleh (termasuk klien yang meminta, jika berlisensi).
accessInfo.downloadAccess.nonce string Nonce klien untuk verifikasi. Akses download dan validasi klien saja.
accessInfo.downloadAccess.source string ID aplikasi klien untuk verifikasi. Akses download dan validasi klien saja.
accessInfo.downloadAccess.reasonCode string Kode alasan error/peringatan. Kode tambahan mungkin ditambahkan di masa mendatang. 0 Oke 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 PERINGATAN_used_last_ACCESS
accessInfo.downloadAccess.message string Pesan error/peringatan.
accessInfo.downloadAccess.signature string Tanda tangan respons.
searchInfo object Informasi hasil penelusuran yang terkait dengan volume ini.
searchInfo.textSnippet string Cuplikan teks yang berisi kueri penelusuran.