Volume

Koleksi Volume digunakan untuk melakukan penelusuran atau mencantumkan konten rak buku. Koleksi ini bersifat 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 pribadi "Koleksiku" dan memerlukan autentikasi.
books.mylibrary.bookshelves.volumes.list

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

Representasi Resource

Volume mewakili informasi yang dihosting Google Buku tentang buku atau majalah. Data ini berisi metadata, seperti judul dan penulis, serta data yang dipersonalisasi, seperti apakah buku telah dibeli atau belum. (Kolom volume yang tersedia dalam 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 Subtitel 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. Kemungkinan nilainya 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. Kemungkinan nilainya adalah BUKU atau MAGAZIN.
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 & 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 menjadi bagian dari volume ini. Kategori ini akan menjadi kategori dari daftar kategori yang ditampilkan di bawah yang memiliki bobot tertinggi.
userInfo object Informasi khusus pengguna yang terkait dengan volume ini. (misalnya, halaman yang terakhir dibaca pengguna ini atau apakah dia membeli buku ini)
userInfo.review nested object Ulasan pengguna ini mengenai 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 atau tidak oleh pengguna terautentikasi yang membuat permintaan. (Dalam proyeksi LITE.)
saleInfo object Informasi apa pun tentang volume yang terkait dengan eBookstore dan/atau kemampuan pembelian. Informasi ini dapat bergantung pada negara tempat permintaan berasal (misalnya, 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. Kemungkinan nilainya adalah FOR_SALE, FREE, NOT_FOR_SALE, atau FOR_PREORDER.
saleInfo.isEbook boolean Apakah volume ini merupakan eBook atau bukan (dapat ditambahkan ke rak 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 jual 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 membaca atau mendapatkan teks volume tersebut. Informasi ini dapat bergantung pada negara (buku mungkin berupa domain publik di satu negara, tetapi tidak di negara lainnya, mis.).
accessInfo.country string Kode negara ISO_3166-1 dua huruf yang valid untuk informasi akses ini. (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. Hal ini dapat berlaku untuk eBook maupun 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 atau bukan.
userInfo.updated datetime Stempel waktu saat volume ini terakhir diubah oleh tindakan pengguna, seperti pembaruan posisi membaca, pembelian volume, atau penulisan ulasan. (Format tanggal dan waktu UTC RFC 3339).
userInfo.isPreordered boolean Apakah volume ini telah dipraorder oleh pengguna terautentikasi yang membuat permintaan atau tidak. (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 berupa ALLOWED, ALLOWED_FOR_ACCESSIBILITY, atau NOT_ALLOWED.
accessInfo.epub.isAvailable boolean Adalah epub teks mengalir yang 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 batasan akses lisensi download volume.
accessInfo.downloadAccess.kind string Jenis resource.
accessInfo.downloadAccess.volumeId string Mengidentifikasi volume tempat entri ini berlaku.
accessInfo.downloadAccess.restricted boolean Apakah volume ini memiliki pembatasan akses download.
accessInfo.downloadAccess.deviceAllowed boolean Jika dibatasi, apakah akses diberikan untuk ini (pengguna, perangkat, volume).
accessInfo.downloadAccess.justAcquired boolean Jika deviceAllowed, apakah akses baru saja 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 yang telah diperoleh (termasuk klien yang meminta, jika dilisensikan).
accessInfo.downloadAccess.nonce string Nonce klien untuk verifikasi. Hanya akses download dan validasi klien.
accessInfo.downloadAccess.source string ID aplikasi klien untuk verifikasi. Hanya akses download dan validasi klien.
accessInfo.downloadAccess.reasonCode string Kode alasan error/peringatan. Kode tambahan dapat ditambahkan di masa mendatang. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_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.