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.listbooks.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) | |
selfLink |
string |
URL ke resource ini. (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 |
object |
Daftar link gambar untuk semua ukuran yang tersedia. (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. | |
volumeInfo.previewLink |
string |
URL untuk melihat pratinjau volume ini di situs Google Buku. | |
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.) | |
saleInfo.buyLink |
string |
URL untuk membeli volume ini di situs Google Buku. (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.epub.downloadLink |
string |
URL untuk mendownload epub. (Dalam proyeksi LITE.) | |
accessInfo.epub.acsTokenLink |
string |
URL untuk mengambil token ACS untuk download epub. (Dalam proyeksi LITE.) | |
accessInfo.pdf |
object |
Informasi tentang konten PDF. (dalam proyeksi LITE) | |
accessInfo.pdf.downloadLink |
string |
URL untuk mendownload PDF. (Dalam proyeksi LITE.) | |
accessInfo.pdf.acsTokenLink |
string |
URL untuk mengambil token ACS untuk download 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. | |
|
string |
URL untuk melihat informasi tentang volume ini di situs Google Buku. (Dalam proyeksi LITE) | |
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). | |
volumeInfo.canonicalVolumeLink |
string |
URL kanonis untuk volume. (Dalam proyeksi LITE.) | |
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.webReaderLink |
string |
URL untuk membaca volume ini di situs Google Buku. Link tidak akan mengizinkan pengguna membaca volume yang tidak terlihat. | |
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. |