Volume
koleksiyonu, arama yapmak veya kitap rafının içeriğini listelemek için kullanılır. Bu koleksiyon salt okunur bir koleksiyon.Yöntemler
Aşağıdaki yöntemler hacimlerle ilgili herkese açık veriler için geçerlidir ve kimlik doğrulama 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.bookshlf.volumes.list- edin
- Kimliğe göre bir Ses kaynağı alır.
- list
- Kitap araması gerçekleştirir.
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ş veriler içerir. (LITE projeksiyonunda 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 projeksiyonunda.) | |
id |
string |
Birim için benzersiz tanımlayıcı. (LITE projeksiyonunda.) | |
etag |
string |
Bir hacim kaynağının belirli bir sürümü için opak tanımlayıcı. (LITE projeksiyonunda) | |
selfLink |
string |
Bu kaynağın URL'si. (LITE projeksiyonunda.) | |
volumeInfo |
object |
Genel hacim bilgileri. | |
volumeInfo.title |
string |
Cilt başlığı. (LITE projeksiyonunda.) | |
volumeInfo.subtitle |
string |
Ses düzeyi altyazısı. (LITE projeksiyonunda.) | |
volumeInfo.authors[] |
list |
Bu ciltteki yazarların ve/veya editörlerin adları. (LITE projeksiyonunda) | |
volumeInfo.publisher |
string |
Bu cildin yayıncısı. (LITE projeksiyonunda.) | |
volumeInfo.publishedDate |
string |
Yayınlanma tarihi. (LITE projeksiyonunda.) | |
volumeInfo.description |
string |
Hacim özeti. Açıklama metni HTML olarak biçimlendirilir ve b, i ve br etiketleri gibi basit biçimlendirme öğelerini içerir. (LITE tahmininde) | |
volumeInfo.industryIdentifiers[] |
list |
Bu hacim 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'dır. | |
volumeInfo.industryIdentifiers[].identifier |
string |
Sektöre özgü hacim tanımlayıcısı. | |
volumeInfo.pageCount |
integer |
Toplam sayfa sayısı. | |
volumeInfo.dimensions |
object |
Bu birimin fiziksel boyutları. | |
volumeInfo.dimensions.height |
string |
Bu birimin yüksekliği veya uzunluğu (cm olarak). | |
volumeInfo.dimensions.width |
string |
Bu hacmin genişliği (cm cinsinden). | |
volumeInfo.dimensions.thickness |
string |
Bu hacmin kalınlığı (cm olarak). | |
volumeInfo.printType |
string |
Bu cildin yayınlanma türü. Olası değerler BOOK veya MAGAZINE'dir. | |
volumeInfo.categories[] |
list |
"Kurgu", "Gerilim" 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 cildin yorum puanı sayısı. | |
volumeInfo.contentVersion |
string |
Birim içeriğinin (metin ve resimler) sürümünün tanımlayıcısı. (LITE projeksiyonunda) | |
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 (yaklaşık 128 piksel genişliğinde) için resim bağlantısı. (LITE tahmininde) | |
volumeInfo.imageLinks.small |
string |
Küçük boyut için resim bağlantısı (yaklaşık 300 piksel genişlik). (LITE tahmininde) | |
volumeInfo.imageLinks.medium |
string |
Orta boyutlu (yaklaşık 575 piksel genişlik) resim bağlantısı. (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 |
Fazla büyük boyut için resim bağlantısı (yaklaşık 1.280 piksel genişlik). (LITE tahmininde) | |
volumeInfo.language |
string |
Bu cilt için en iyi dil (içeriği temel alır). Bu, "fr", "en" vb. gibi iki harfli ISO 639-1 kodudur. | |
volumeInfo.mainCategory |
string |
Bu hacme ait olduğu ana kategori. Bu, aşağıda döndürülen kategoriler listesinden en çok ağırlığa sahip kategoridir. | |
volumeInfo.previewLink |
string |
Bu kitabın Google Kitaplar sitesinde önizleneceği URL. | |
userInfo |
object |
Bu ciltle ilgili kullanıcıya özel bilgiler. (ör. bu kullanıcının en son okuduğu sayfa veya bu kitabı satın alıp almadığı) | |
userInfo.review |
nested object |
Varsa bu hacimdeki kullanıcı yorumu. | |
userInfo.readingPosition |
readingPosition Resource |
Varsa kullanıcının hacimdeki mevcut okuma konumu. (LITE projeksiyonunda.) | |
userInfo.isPurchased |
boolean |
Bu cildin, istekte bulunan kimliği doğrulanmış kullanıcı tarafından satın alınıp alınmadığı. (LITE projeksiyonunda.) | |
saleInfo |
object |
e-Kitapçı ve/veya satın alınabilirlikle ilgili hacim hakkında bilgiler. Bu bilgiler, isteğin geldiği ülkeye bağlı olabilir (ör. kitaplar belirli ülkelerde satılık olmayabilir). | |
saleInfo.country |
string |
Bu satış bilgilerinin geçerli olduğu iki harfli ISO_3166-1 ülke kodu. (LITE projeksiyonunda.) | |
saleInfo.saleability |
string |
Bu kitabın yukarıda listelenen ülke için Google e-Kitap Mağazası'nda satılıyor veya ücretsiz olarak sunulup sunulmadığı. Olası değerler FOR_SALE, ÜCRETSİZ, NOT_FOR_SALE veya FOR_PREORDER. | |
saleInfo.isEbook |
boolean |
Bu ciltte e-kitap olup olmadığı (e-Kitaplarım rafına eklenebilir). | |
saleInfo.listPrice |
object |
Önerilen perakende satış fiyatı. (LITE tahmininde) | |
saleInfo.listPrice.amount |
double |
Tutarın aşağıda listelenen para birimi cinsinden tutarı. (LITE projeksiyonunda.) | |
saleInfo.listPrice.currencyCode |
string |
ISO 4217, üç harfli para birimi kodu. (LITE projeksiyonunda.) | |
saleInfo.retailPrice |
object |
Kitabın gerçek satış fiyatı. Bu ciltte teklifler veya indirimler yoksa bu, önerilen perakende veya liste fiyatıyla aynıdır. (LITE tahmininde) | |
saleInfo.retailPrice.amount |
double |
Tutarın aşağıda listelenen para birimi cinsinden tutarı. (LITE projeksiyonunda.) | |
saleInfo.retailPrice.currencyCode |
string |
ISO 4217, üç harfli para birimi kodu. (LITE projeksiyonunda.) | |
saleInfo.buyLink |
string |
Bu kitabı Google Kitaplar sitesinden satın almak için kullanılan URL. (LITE tahmininde) | |
accessInfo |
object |
Birim metnini okumak veya almakla ilgili bilgiler. Bu bilgiler ülkeye göre değişebilir (kitaplar bir ülkede kamu alanı olabilir ancak başka bir ülkede olmayabilir). | |
accessInfo.country |
string |
Bu erişim bilgilerinin geçerli olduğu iki harfli ISO_3166-1 ülke kodu. (LITE projeksiyonunda.) | |
accessInfo.viewability |
string |
Birimin okuma erişimi. Olası değerler PARTIAL, ALL_PAGE, NO_PAGE veya UNKNOWN'dir. Bu değer, yukarıda listelenen ülkeye bağlıdır. PARTIAL değeri, yayıncının birimin bir bölümünün, satın alınmadan herkese açık olarak görüntülenmesine izin verdiği anlamına gelir. Bu durum e-Kitapların yanı sıra e-Kitaplar için de geçerli olabilir. Kamu alanı kitapları her zaman ALL_PAGE değerine sahip olur. | |
accessInfo.epub |
object |
Epub içeriği hakkında bilgi. (LITE tahmininde) | |
accessInfo.epub.downloadLink |
string |
Epub'ı indirmek için URL. (LITE projeksiyonunda.) | |
accessInfo.epub.acsTokenLink |
string |
Epub indirme işlemi için ACS jetonu alınacak. (LITE projeksiyonunda.) | |
accessInfo.pdf |
object |
PDF içeriği hakkında bilgi. (LITE tahmininde) | |
accessInfo.pdf.downloadLink |
string |
PDF dosyasının indirileceği URL. (LITE projeksiyonunda.) | |
accessInfo.pdf.acsTokenLink |
string |
PDF dosyasını indirmek için ACS jetonu alınacak. (LITE projeksiyonunda.) | |
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 projeksiyonunda.) | |
accessInfo.embeddable |
boolean |
Yerleşik Görüntüleyici API'si kullanılarak bu sesin görüntü alanına yerleştirilip yerleştirilmeyeceği. | |
accessInfo.publicDomain |
boolean |
Bu kitabın yukarıda listelenen ülkede herkese açık olup olmadığı. | |
|
string |
Google Kitaplar sitesinde bu ciltle ilgili bilgileri görüntüleme URL'si. (LITE projeksiyonunda) | |
userInfo.updated |
datetime |
Okuma konumu güncellemesi, hacim satın alma veya yorum yazma gibi bir kullanıcı işlemi tarafından bu birimin son değiştirildiği zaman damgası. (RFC 3339 UTC tarih ve saat biçimi). | |
volumeInfo.canonicalVolumeLink |
string |
Birim için standart URL. (LITE projeksiyonunda.) | |
userInfo.isPreordered |
boolean |
İstekte bulunan kimliği doğrulanmış kullanıcı tarafından bu cilt için ön sipariş verilip verilmediği. (LITE projeksiyonunda.) | |
saleInfo.onSaleDate |
datetime |
Bu kitabın satışa sunulacağı tarih. | |
accessInfo.textToSpeechPermission |
string |
Bu cilt için metin okumaya izin verilip verilmediği. Değerler İZİN VERİLDİ, İZİN_VERİLDİ veya İZİN VERİLMİYOR olabilir. | |
accessInfo.epub.isAvailable |
boolean |
Akan metin epub'ı kamu alanı olarak mı yoksa satın alma için mi kullanılabilir? (LITE projeksiyonunda.) | |
accessInfo.pdf.isAvailable |
boolean |
Taranan resim pdf dosyası kamu alanı olarak veya satın alınabilir durumda mı? (LITE projeksiyonunda.) | |
accessInfo.webReaderLink |
string |
Google Kitaplar sitesinde bu cildi okumak için URL. Bağlantı, kullanıcıların görüntülenemeyen birimleri okumasına izin vermiyor. | |
accessInfo.downloadAccess |
nested object |
Birim için indirme lisansı erişim 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ıtlamaları olup olmadığı. | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
Kısıtlanması durumunda, buna (kullanıcı, cihaz, hacim) erişim izni verilip verilmediği. | |
accessInfo.downloadAccess.justAcquired |
boolean |
Cihaza izin veriliyorsa erişimin bu istekle yeni alınmış olup olmadığı. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
Kısıtlanmışsa bu birim için maksimum içerik indirme lisansı sayısı. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
Kısıtlanmışsa, daha önce edinilmiş olan içerik indirme lisanslarının sayısı (lisans, lisans veren istemci dahil). | |
accessInfo.downloadAccess.nonce |
string |
Doğrulama için istemci tek seferlik. Yalnızca indirme erişimi ve istemci doğrulaması. | |
accessInfo.downloadAccess.source |
string |
Doğrulama için istemci uygulaması tanımlayıcı. Yalnızca indirme erişimi ve istemci doğrulaması. | |
accessInfo.downloadAccess.reasonCode |
string |
Hata/uyarı nedeni kodu. İleride başka kodlar eklenebilir. 0 OK 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 ciltle ilgili arama sonucu bilgileri. | |
searchInfo.textSnippet |
string |
Arama sorgusunu içeren bir metin snippet'i. |