Ses Düzeyi

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.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.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)
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.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.
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.)
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.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 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ığı.
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).
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.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.