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 "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) | |
selfLink |
string |
URL untuk resource ini. (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 |
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). 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. | |
volumeInfo.previewLink |
string |
URL untuk melihat pratinjau volume ini di situs Google Buku. | |
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.) | |
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 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.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. | |
|
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 waktu dan tanggal 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. (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.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 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. |