Hacim

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ı 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. (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ü. (BASİT projeksiyonda.)
id string Bir birimin benzersiz tanımlayıcısı. (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 Cilt alt başlığı. (BASİT projeksiyonda.)
volumeInfo.authors[] list Bu cildin yazarlarının ve/veya editörlerinin adları. (LITE projeksiyonunda)
volumeInfo.publisher string Bu cildin yayıncısı. (BASİT projeksiyonda.)
volumeInfo.publishedDate string Yayınlanma tarihi. (BASİT projeksiyonda.)
volumeInfo.description string Cildin özeti. Açıklamanın metni HTML olarak biçimlendirilir ve b, i ve 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 cildin 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ünü tanımlayan bir tanımlayıcı. (LITE projeksiyonunda)
volumeInfo.imageLinks.thumbnail string Küçük resim boyutu için resim bağlantısı ("128 piksel" genişliğinde). (LITE projeksiyonunda)
volumeInfo.imageLinks.small string Küçük boyut için resim bağlantısı ("300 piksel" genişliğinde). (LITE projeksiyonunda)
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 boyutlu resim bağlantısı ("800 piksel" genişliğinde). (LITE projeksiyonunda)
volumeInfo.imageLinks.smallThumbnail string Küçük küçük resim boyutu (yaklaşık 80 piksel genişliğinde) 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 projeksiyonunda)
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 cildin 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. kullanıcının en 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 Kullanıcının ciltte okumakta olduğu konum (varsa). (BASİT projeksiyonda.)
userInfo.isPurchased boolean Bu cildin, istekte bulunan kimliği doğrulanmış kullanıcı tarafından satın alınıp alınmadığı. (BASİT projeksiyonda.)
saleInfo object E-kitap mağazasıyla ve/veya satın alınabilirlikle ilgili bir ciltle ilgili tüm 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 projeksiyonunda)
saleInfo.listPrice.amount double Aşağıda listelenen para biriminde tutar. (BASİT projeksiyonda.)
saleInfo.listPrice.currencyCode string ISO 4217 standardına uygun üç 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 standardına uygun üç 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 birimin okuma erişimi. Olası değerler PARTIAL, ALL_PAGES, NO_PAGES veya UNKNOWN'dur. Bu değer, yukarıda listelenen ülkeye bağlıdır. 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. (BASİT projeksiyonda.)
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 cildin, isteği yapan kimliği doğrulanmış kullanıcı tarafından ön siparişe alınıp alınmadığı. (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 Herkese açık veya satın alınabilir bir akan metin epub'u olmalıdır. (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 elde edildiği.
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 Doğrulama için istemci tek seferlik rastgele numarası. 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.