Volume
koleksiyonları, arama yapmak veya kitap rafının içeriğini listelemek için kullanılır. Bu koleksiyon salt okunur bir koleksiyondur.Yöntemler
Aşağıdaki yöntemler, birimlerle ilgili herkese açık veriler için geçerlidir ve kimlik doğrulaması gerektirmez.
books.volumes.listbooks.volumes.get
Aşağıdaki yöntem, birimlerin gizli "Kitaplığım" görünümü için geçerlidir ve kimlik doğrulama gerektirir.
books.mylibrary.bookshelves.volumes.list- al
- Kimliğe göre bir Hacim kaynağı alır.
- list
- Kitap araması yapar.
Kaynak temsilleri
Cilt, Google Kitaplar'ın bir kitap veya dergi hakkında barındırdığı bilgileri temsil eder. Başlık ve yazar gibi meta verilerin yanı sıra satın alınıp alınmadığı gibi kişiselleştirilmiş verileri içerir. (Basit projeksiyonda kullanılabilen hacim alanları aşağıda belirtilmiştir).
{ "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 } }
Mülk Adı | Değer | Açıklama | Notlar |
---|---|---|---|
kind |
string |
Birim için kaynak türü. (LITE tahmininde.) | |
id |
string |
Bir birimin benzersiz tanımlayıcısıdır. (LITE tahmininde.) | |
etag |
string |
Birim kaynağının belirli bir sürümünün opak tanımlayıcısı. (LITE tahmininde) | |
selfLink |
string |
Bu kaynağın URL'si. (LITE tahmininde.) | |
volumeInfo |
object |
Genel hacim bilgileri. | |
volumeInfo.title |
string |
Cilt başlığı. (LITE tahmininde.) | |
volumeInfo.subtitle |
string |
Seslendirme altyazısı. (LITE tahmininde.) | |
volumeInfo.authors[] |
list |
Bu cildin yazarlarının ve/veya editörlerinin adları. (LITE tahmininde) | |
volumeInfo.publisher |
string |
Bu cildin yayıncısı. (LITE tahmininde.) | |
volumeInfo.publishedDate |
string |
Yayın tarihi. (LITE tahmininde.) | |
volumeInfo.description |
string |
Cildin özetidir. Açıklama metni HTML'de biçimlendirilir ve b, i, br etiketleri gibi basit biçimlendirme öğeleri içerir. (LITE tahmininde) | |
volumeInfo.industryIdentifiers[] |
list |
Bu birim için endüstri standardı tanımlayıcılar. | |
volumeInfo.industryIdentifiers[].type |
string |
Tanımlayıcı türü. Olası değerler: ISBN_10, ISBN_13, ISSN ve OTHER. | |
volumeInfo.industryIdentifiers[].identifier |
string |
Sektöre özel birim tanımlayıcısı. | |
volumeInfo.pageCount |
integer |
Toplam sayfa sayısı. | |
volumeInfo.dimensions |
object |
Bu birimin fiziksel boyutları. | |
volumeInfo.dimensions.height |
string |
Bu cildin yüksekliği veya uzunluğu (cm cinsinden). | |
volumeInfo.dimensions.width |
string |
Bu hacmin genişliği (cm). | |
volumeInfo.dimensions.thickness |
string |
Bu hacmin kalınlığı (cm cinsinden). | |
volumeInfo.printType |
string |
Bu cildin yayın türü. Olası değerler BOOK veya MAGAZINE'dir. | |
volumeInfo.categories[] |
list |
"Kurgu", "Gizem" gibi konu kategorilerinin bir listesi. | |
volumeInfo.averageRating |
double |
Bu cilt için ortalama yorum puanı. (min.= 1,0, maks.= 5,0) | |
volumeInfo.ratingsCount |
integer |
Bu cilt için yorum puanlarının sayısı. | |
volumeInfo.contentVersion |
string |
Cilt içeriğinin (metin ve resimler) sürümü için bir tanımlayıcı. (LITE tahmininde) | |
volumeInfo.imageLinks |
object |
Kullanılabilir tüm boyutlar için resim bağlantılarının listesi. (LITE tahmininde) | |
volumeInfo.imageLinks.thumbnail |
string |
Küçük resim boyutu için resim bağlantısı (genişlik yaklaşık 128 piksel). (LITE tahmininde) | |
volumeInfo.imageLinks.small |
string |
Küçük boyutlu (yaklaşık 300 piksel genişlik) resim bağlantısı. (LITE tahmininde) | |
volumeInfo.imageLinks.medium |
string |
Orta boyut için resim bağlantısı (genişlik yaklaşık 575 piksel). (LITE tahmininde) | |
volumeInfo.imageLinks.large |
string |
Büyük boyut (yaklaşık 800 piksel genişlik) için resim bağlantısı. (LITE tahmininde) | |
volumeInfo.imageLinks.smallThumbnail |
string |
Küçük resim boyutu (yaklaşık 80 piksel genişlik) için resim bağlantısı. (LITE tahmininde) | |
volumeInfo.imageLinks.extraLarge |
string |
Çok büyük boyut (yaklaşık 1.280 piksel genişlik) için resim bağlantısı. (LITE tahmininde) | |
volumeInfo.language |
string |
Bu hacim için en iyi dil (içeriğe göre). "fr", "en" vb. gibi iki harfli ISO 639-1 kodudur. | |
volumeInfo.mainCategory |
string |
Bu hacmin ait olduğu ana kategori. Aşağıda döndürülen kategori listesindeki en yüksek ağırlığa sahip kategori olacaktır. | |
volumeInfo.previewLink |
string |
Bu cildi Google Kitaplar sitesinde önizleme URL'si. | |
userInfo |
object |
Bu hacimle ilgili kullanıcıya özel bilgiler. (ör. bu kullanıcının son okuduğu sayfa veya bu kitabı satın alıp almadığı) | |
userInfo.review |
nested object |
Bu kullanıcının bu ciltle ilgili yorumu (varsa). | |
userInfo.readingPosition |
readingPosition Resource |
Varsa kullanıcının ciltteki geçerli okuma konumu. (LITE tahmininde.) | |
userInfo.isPurchased |
boolean |
Bu hacmin, istekte bulunan kimliği doğrulanmış kullanıcı tarafından satın alınıp alınmadığını belirtir. (LITE tahmininde.) | |
saleInfo |
object |
E-Kitap Mağazası ve/veya satın alınabilirlikle ilgili cilt hakkındaki bilgiler. Bu bilgiler, talebin geldiği ülkeye bağlı olabilir (ör. kitaplar belirli ülkelerde satılmıyor olabilir). | |
saleInfo.country |
string |
Bu satış bilgilerinin geçerli olduğu iki harfli ISO_3166-1 ülke kodu. (LITE tahmininde.) | |
saleInfo.saleability |
string |
Bu kitabın yukarıda listelenen ülke için Google e-Kitap Mağazası'nda satışa sunulup sunulmadığı veya ücretsiz olarak sunulup sunulmadığı. Olası değerler: FOR_SALE, FREE, NOT_FOR_SALE veya FOR_PREORDER. | |
saleInfo.isEbook |
boolean |
Bu cildin bir e-Kitap olup olmadığı (e-Kitaplarım rafına eklenebilir). | |
saleInfo.listPrice |
object |
Önerilen perakende satış fiyatı. (LITE tahmininde) | |
saleInfo.listPrice.amount |
double |
Aşağıda listelenen para birimi cinsinden tutar. (LITE tahmininde.) | |
saleInfo.listPrice.currencyCode |
string |
ISO 4217, üç harfli para birimi kodu. (LITE tahmininde.) | |
saleInfo.retailPrice |
object |
Kitabın gerçek satış fiyatı. Bu hacimde fırsat veya indirim olmadığı sürece, önerilen perakende satış veya liste fiyatıyla aynıdır. (LITE tahmininde) | |
saleInfo.retailPrice.amount |
double |
Aşağıda listelenen para birimi cinsinden tutar. (LITE tahmininde.) | |
saleInfo.retailPrice.currencyCode |
string |
ISO 4217, üç harfli para birimi kodu. (LITE tahmininde.) | |
saleInfo.buyLink |
string |
Bu cildi Google Kitaplar sitesinde satın almak için kullanacağınız URL. (LITE tahmininde) | |
accessInfo |
object |
Belirli bir ciltteki metnin okunması veya elde edilmesiyle ilgili tüm bilgiler. Bu bilgiler ülkeye göre değişebilir (kitaplar bir ülkede kamu alanında olabilir ancak başka bir ülkede olmayabilir, ör.). | |
accessInfo.country |
string |
Bu erişim bilgilerinin geçerli olduğu iki harfli ISO_3166-1 ülke kodu. (LITE tahmininde.) | |
accessInfo.viewability |
string |
Bir cildi okuma erişimi. Olası değerler: PARTIAL, ALL_PAGES, NO_PAGES veya UNKNOWN. Bu değer, yukarıda listelenen ülkeye göre değişir. PARTIAL değeri, yayıncının kitabın bir bölümünün satın almadan herkese açık olarak görüntülenmesine izin verdiği anlamına gelir. Bu durum, e-kitapların yanı sıra e-kitap olmayan kitaplar için de geçerli olabilir. Genel alandaki kitapların değeri her zaman ALL_PAGES olur. | |
accessInfo.epub |
object |
EPUB içeriği hakkında bilgi. (LITE tahmininde) | |
accessInfo.epub.downloadLink |
string |
EPUB indirme URL'si. (LITE tahmininde.) | |
accessInfo.epub.acsTokenLink |
string |
EPUB indirmesi için ACS jetonunu alma URL'si. (LITE tahmininde.) | |
accessInfo.pdf |
object |
PDF içeriği hakkında bilgi. (LITE tahmininde) | |
accessInfo.pdf.downloadLink |
string |
PDF indirme URL'si. (LITE tahmininde.) | |
accessInfo.pdf.acsTokenLink |
string |
PDF indirmek üzere ACS jetonunu alma URL'si. (LITE tahmininde.) | |
accessInfo.accessViewStatus |
string |
Bu birimin erişimini ve görüntülenebilirliğini bu kullanıcı için tek bir durum alanında birleştirir. Değerler FULL_PURCHASED, FULL_PUBLIC_DOMAIN, sample veya NONE olabilir. (LITE tahmininde.) | |
accessInfo.embeddable |
boolean |
Bu birimin, Embedded Viewer API kullanılarak görüntü alanına yerleştirilip yerleştirilemeyeceği. | |
accessInfo.publicDomain |
boolean |
Bu kitabın yukarıda listelenen ülkede kamu alanında olup olmadığı. | |
|
string |
Google Kitaplar sitesinde bu ciltle ilgili bilgileri görüntülemek için URL. (LITE tahmininde) | |
userInfo.updated |
datetime |
Bu cildin okuma konumu güncellemesi, cilt satın alma veya yorum yazma gibi bir kullanıcı işlemi tarafından en son değiştirildiği anın zaman damgası. (RFC 3339 UTC tarih-saat biçimi). | |
volumeInfo.canonicalVolumeLink |
string |
Cildin standart URL'si. (LITE tahmininde.) | |
userInfo.isPreordered |
boolean |
Bu birimin, istekte bulunan kimliği doğrulanmış kullanıcı tarafından ön sipariş verilip verilmediği. (LITE tahmininde.) | |
saleInfo.onSaleDate |
datetime |
Bu kitabın satışa sunulduğu tarih. | |
accessInfo.textToSpeechPermission |
string |
Bu ses seviyesi için metin okumaya izin verilip verilmediği. Değerler ALLOWED, ALLOWED_FOR_ACCESSIBILITY veya NOT_ALLOWED olabilir. | |
accessInfo.epub.isAvailable |
boolean |
Kamu alanında veya satın alınabilen akan metin epub'ı. (LITE tahmininde.) | |
accessInfo.pdf.isAvailable |
boolean |
Kamu alanında bulunan veya satın alınabilen taranmış bir resim PDF'si (LITE tahmininde.) | |
accessInfo.webReaderLink |
string |
Bu cildi Google Kitaplar sitesinde okumak için kullanılacak URL. Bağlantı, kullanıcıların görüntülenemeyen birimleri okumasına izin vermeyecek. | |
accessInfo.downloadAccess |
nested object |
Bir birimin indirme lisansı erişimi kısıtlamaları hakkında bilgi. | |
accessInfo.downloadAccess.kind |
string |
Kaynak türü. | |
accessInfo.downloadAccess.volumeId |
string |
Bu girişin geçerli olduğu hacmi tanımlar. | |
accessInfo.downloadAccess.restricted |
boolean |
Bu birimde indirme erişimi kısıtlaması olup olmadığı. | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
Kısıtlanmışsa bu özelliğe (kullanıcı, cihaz, birim) erişim izni verilip verilmediğini belirtir. | |
accessInfo.downloadAccess.justAcquired |
boolean |
deviceAllowed ise erişimin bu istekle yeni edinilip edinilmediğini belirtir. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
Kısıtlanmışsa bu cilt için maksimum içerik indirme lisansı sayısı. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
Kısıtlanmışsa daha önce edinilen içerik indirme lisanslarının sayısı (lisanslıysa talep eden istemci dahil). | |
accessInfo.downloadAccess.nonce |
string |
İstemcinin doğrulama için tek seferlik rastgele sayısı. İndirme erişimi ve yalnızca istemci doğrulaması. | |
accessInfo.downloadAccess.source |
string |
Doğrulama için istemci uygulaması tanımlayıcısı. İndirme erişimi ve yalnızca istemci doğrulaması. | |
accessInfo.downloadAccess.reasonCode |
string |
Hata/uyarı nedeni kodu. İleride başka kodlar da eklenebilir. 0 TAMAM 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USE_LAST_ACCESS | |
accessInfo.downloadAccess.message |
string |
Hata/uyarı mesajı. | |
accessInfo.downloadAccess.signature |
string |
Yanıt imzası. | |
searchInfo |
object |
Bu hacimle ilgili arama sonucu bilgileri. | |
searchInfo.textSnippet |
string |
Arama sorgusunu içeren bir metin snippet'i. |