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 pribadi "Koleksiku" 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. Data tersebut berisi metadata, seperti judul dan penulis, serta data yang dipersonalisasi, seperti apakah konten tersebut sudah dibeli atau belum. (Kolom volume yang tersedia dalam proyeksi LITE tercantum di bawah ini).

{
  "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-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 Total jumlah 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 & 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). 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 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 saat ini oleh pengguna 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 tempat informasi penjualan ini valid. (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 mungkin adalah FOR_SALE, FREE, NOT_FOR_SALE, atau FOR_PREORDER.
saleInfo.isEbook boolean Apakah volume ini merupakan eBook (dapat ditambahkan ke rak eBook Saya).
saleInfo.listPrice object Harga eceran 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 penjualan 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 berada di domain publik di satu negara, tetapi tidak di negara lain, misalnya).
accessInfo.country string Kode negara ISO_3166-1 dua huruf tempat informasi akses ini 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 dilihat secara publik, tanpa pembelian. 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 tidak.
userInfo.updated datetime Stempel waktu saat volume ini terakhir diubah oleh tindakan pengguna, seperti pembaruan posisi membaca, pembelian volume, atau menulis ulasan. (Format tanggal-waktu RFC 3339 UTC).
userInfo.isPreordered boolean Apakah volume ini 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 atau tidak. Nilai dapat DIIZINKAN, 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 untuk volume.
accessInfo.downloadAccess.kind string Jenis resource.
accessInfo.downloadAccess.volumeId string Mengidentifikasi volume yang berlaku untuk entri ini.
accessInfo.downloadAccess.restricted boolean Apakah volume ini memiliki batasan akses download.
accessInfo.downloadAccess.deviceAllowed boolean Jika dibatasi, apakah akses diberikan untuk hal ini (pengguna, perangkat, volume).
accessInfo.downloadAccess.justAcquired boolean Jika deviceAllowed, apakah akses baru saja diperoleh dengan permintaan ini atau tidak.
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 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 dapat ditambahkan di masa mendatang. 0 Oke 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_WARNING_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.