Ses Düzeyi

Volume Koleksiyonlar, kitaplıktaki içerikleri aramak veya listelemek için kullanılır. Bu koleksiyon salt okunur bir koleksiyondur.

Yöntemler

Aşağıdaki yöntemler, ciltlerle 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, ciltlerin özel "Kitaplığım" görünümü için geçerlidir ve kimlik doğrulama gerektirir.
books.mylibrary.bookshelves.volumes.list

get
Kimliğe göre bir Hacim 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ş verileri 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 Bir birim için kaynak türü. (LITE tahmininde.)
id string Bir birimin benzersiz tanımlayıcısıdır. (BASİT projeksiyonda.)
etag string Bir birim kaynağının belirli bir sürümü için opak tanımlayıcı. (LITE projeksiyonunda)
volumeInfo object Genel ses düzeyi bilgileri.
volumeInfo.title string Cilt başlığı. (BASİT projeksiyonda.)
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ı. (BASİT projeksiyonda.)
volumeInfo.publishedDate string Yayınlanma tarihi. (BASİT projeksiyonda.)
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 projeksiyonunda)
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 cildin fiziksel boyutları.
volumeInfo.dimensions.height string Bu cildin yüksekliği veya uzunluğu (cm cinsinden).
volumeInfo.dimensions.width string Bu cildin genişliği (cm cinsinden).
volumeInfo.dimensions.thickness string Bu birimin kalınlığı (cm cinsinden).
volumeInfo.printType string Bu cildin yayın türü. Olası değerler KİTAP veya DERGİ'dir.
volumeInfo.categories[] list "Kurgu", "Gerilim" gibi konu kategorilerinin listesi.
volumeInfo.averageRating double Bu cilt için ortalama yorum puanı. (min = 1,0, maks = 5,0)
volumeInfo.ratingsCount integer Bu cilt için verilen 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 projeksiyonunda)
volumeInfo.imageLinks.thumbnail string Küçük resim boyutu için resim bağlantısı (genişlik yaklaşık 128 piksel). (LITE projeksiyonunda)
volumeInfo.imageLinks.small string Küçük boyut için resim bağlantısı ("300 piksel" genişliğinde). (LITE tahmininde)
volumeInfo.imageLinks.medium string Orta boy (yaklaşık 575 piksel genişliğinde) resim bağlantısı. (LITE projeksiyonunda)
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 projeksiyonunda)
volumeInfo.imageLinks.extraLarge string Ekstra büyük boyut için resim bağlantısı ("1280 piksel" genişliğinde). (LITE tahmininde)
volumeInfo.language string Bu cilt için en uygun dil (içeriğe göre). "fr", "en" 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 listesinde en yüksek ağırlığa sahip kategoridir.
userInfo object Bu hacimle ilgili kullanıcıya özgü 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 cilt hakkındaki yorumu (varsa).
userInfo.readingPosition readingPosition Resource Varsa kullanıcının ciltteki geçerli okuma konumu. (LITE tahmininde.)
userInfo.isPurchased boolean Bu cildin, isteği yapan kimliği doğrulanmış kullanıcı tarafından satın alınıp alınmadığı. (BASİT projeksiyonda.)
saleInfo object E-Kitap Mağazası ve/veya satın alınabilirlikle ilgili cilt hakkındaki bilgiler. Bu bilgiler, isteğin gönderildiği ülkeye bağlı olabilir (ör. kitaplar belirli ülkelerde satılmayabilir).
saleInfo.country string Bu indirim bilgilerinin geçerli olduğu iki harfli ISO_3166-1 ülke kodu. (BASİT projeksiyonda.)
saleInfo.saleability string Bu kitabın, yukarıda listelenen ülke için Google E-Kitaplar'da satılıp satılmadığı veya ücretsiz olarak sunulup sunulmadığı. Olası değerler: FOR_SALE, FREE, NOT_FOR_SALE veya FOR_PREORDER.
saleInfo.isEbook boolean Bu cildin e-kitap olup olmadığı (E-Kitaplar rafıma eklenebilir).
saleInfo.listPrice object Önerilen perakende satış fiyatı. (LITE tahmininde)
saleInfo.listPrice.amount double Aşağıda listelenen para biriminde tutar. (BASİT projeksiyonda.)
saleInfo.listPrice.currencyCode string ISO 4217, üç harfli para birimi kodu. (BASİT projeksiyonda.)
saleInfo.retailPrice object Kitabın gerçek satış fiyatı. Bu hacimde teklif veya indirim yoksa bu fiyat, önerilen perakende fiyatı veya liste fiyatı ile aynıdır. (LITE projeksiyonunda)
saleInfo.retailPrice.amount double Aşağıda listelenen para biriminde tutar. (BASİT projeksiyonda.)
saleInfo.retailPrice.currencyCode string ISO 4217, üç harfli para birimi kodu. (BASİT projeksiyonda.)
accessInfo object Bir ciltle ilgili olarak, o cildin metnini okuma veya edinmeyle ilgili tüm bilgiler. Bu bilgiler ülkeye göre değişebilir (ör. kitaplar bir ülkede kamu alanında 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. (BASİT projeksiyonda.)
accessInfo.viewability string Bir cildi okuma erişimi. Olası değerler PARTIAL, ALL_PAGES, NO_PAGES veya UNKNOWN'dur. Bu değer, yukarıda listelenen ülkeye göre değişir. PARTIAL değeri, yayıncının hacmin bir kısmının satın alma işlemi olmadan herkese açık olarak görüntülenmesine izin verdiği anlamına gelir. Bu durum, e-kitaplar ve e-kitap olmayanlar için geçerli olabilir. Herkese açık kitapların değeri her zaman ALL_PAGES olur.
accessInfo.epub object Epub içeriği hakkında bilgi. (LITE projeksiyonunda)
accessInfo.pdf object PDF içeriği hakkında bilgi. (LITE projeksiyonunda)
accessInfo.accessViewStatus string Bu kullanıcının bu birime erişimini ve görüntülenebilirliğini tek bir durum alanında birleştirir. Değerler FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE veya NONE olabilir. (LITE tahmininde.)
accessInfo.embeddable boolean Bu cildin, Embedded Viewer API kullanılarak bir 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 bir kullanıcı işlemi (ör. okuma konumu güncelleme, cilt satın alma veya yorum yazma) tarafından en son değiştirildiği zaman damgası. (RFC 3339 UTC tarih ve saat biçimi).
userInfo.isPreordered boolean Bu birimin, istekte bulunan kimliği doğrulanmış kullanıcı tarafından ön sipariş verilip verilmediği. (BASİT projeksiyonda.)
saleInfo.onSaleDate datetime Bu kitabın satışa sunulacağı tarih.
accessInfo.textToSpeechPermission string Bu ciltte metin okumaya izin verilip verilmediğini belirtir. Değerler ALLOWED, ALLOWED_FOR_ACCESSIBILITY veya NOT_ALLOWED olabilir.
accessInfo.epub.isAvailable boolean Kamu alanı olarak veya satın alınabilen akan metin epub'ı. (BASİT projeksiyonda.)
accessInfo.pdf.isAvailable boolean Taratılmış resim PDF'si, herkese açık olarak veya satın alınabilir olarak sunulmalıdır. (BASİT projeksiyonda.)
accessInfo.downloadAccess nested object Bir birimin 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 birimi tanımlar.
accessInfo.downloadAccess.restricted boolean Bu birimde indirme erişimi kısıtlaması olup olmadığı.
accessInfo.downloadAccess.deviceAllowed boolean Kısıtlanmışsa buna (kullanıcı, cihaz, ses seviyesi) erişim izni verilip verilmediği.
accessInfo.downloadAccess.justAcquired boolean deviceAllowed ise erişimin bu istekle yeni mi edinildiğini belirtir.
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 edinilen içerik indirme lisanslarının sayısı (lisanslıysa istemci dahil).
accessInfo.downloadAccess.nonce string İstemcinin doğrulama için tek seferlik rastgele sayısı. Yalnızca indirme erişimi ve istemci doğrulaması.
accessInfo.downloadAccess.source string Doğrulama için istemci uygulaması tanımlayıcısı. Yalnızca indirme erişimi ve istemci doğrulaması.
accessInfo.downloadAccess.reasonCode string Hata/uyarı nedeni kodu. Gelecekte daha fazla kod eklenebilir. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_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.