Ses Düzeyi

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.list
books.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)
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.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.
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.)
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.pdf object PDF içeriği hakkında bilgi. (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ığı.
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).
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.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.