Bu sayfa, Cloud Translation API ile çevrilmiştir.

Dynamic Links

Google Kitaplar Dinamik Bağlantılar özelliği, sitenizden Google Kitaplar için daha özelleştirilebilir, güvenilir bağlantılar oluşturmanıza olanak tanır. Örneğin, bu araç yalnızca dizinimizdeki kitaplar arasında görünen "akıllı" bağlantılar oluşturmanıza veya kullanıcılara bir kitabın Google Kitaplar'da önizlenip önizlenemeyeceğini gösteren bağlantılar göstermenize olanak tanır. Dinamik Bağlantılar özelliği, Google Kitaplar bağlantınıza küçük resim eklemenizi de sağlar. Bu belge, bu işlevi sitenize hızlı bir şekilde ekleyebilmeniz için hazırlanmıştır.

Not: Bu özellik daha önce Kitap Görüntülenebilirliği API'si olarak biliniyordu.

Önizleme Sihirbazı, Dinamik Bağlantıların üzerine oluşturulmuş bir araçtır. Yalnızca birkaç satır kod kopyalayarak siteden önizlemelere bağlantı oluşturmayı daha da kolaylaştırır. Bu doküman, Kitap Arama'ya bağlama şeklini özelleştirmek isteyen daha gelişmiş geliştiriciler için hazırlanmıştır.

Kitle

Dinamik bağlantılar dokümanları, Google Kitaplar'daki kitaplara bağlantı veren web uygulamaları yazmak isteyen programcılar için hazırlanmıştır. Bu dokümanda HTTP protokolü ve temel JavaScript hakkında bilgi sahibi olduğunuz varsayılmaktadır.

Kitap Arama terminolojisi

Google Kitaplar, kullanıcının yerel telif hakkı kısıtlamalarına uyar ve bu nedenle, bazı kitapların önizlemeleri veya tam görünümleri tüm yerlerde kullanılamaz. Görüntülenebilirlik aşağıdaki sınıflara ayrılır:

Tam Görünüm: Kitabın tamamı görüntülenebilir. Bu kitaplar kamu alanında olabilir.
Sınırlı Önizleme: Kitabın bir kısmı görüntülenebilir. Bu kitap telif hakkı kapsamındadır ve Google Kitaplar bu sayfaları kullanıcılar için erişilebilir hale getirme izni almıştır. Bu kitaplar, kullanıcıların tüm sayfaları görüntüleyebilmesi için Snippet Görüntüleme kitaplarından farklıdır.
Snippet Görünümü ve Önizleme Yok: Kullanıcılar yalnızca "Kitap hakkında" sayfasını görür. Kitaptan yalnızca kısa alıntılar kullanılabilir. Bu kitap taranmamış veya telif hakkı altındadır ve Google Kitaplar'ın, bir kullanıcının arama terimiyle ilgili birkaç snippet'ten daha fazlasını gösterme izni almamıştır.

Giriş

Statik Bağlantılar dokümanında, Google Kitaplar'daki belirli bir kitabın sayfasına ait URL'leri oluşturmanın çok basit bir yolu açıklanmaktadır. Maalesef, bazen bu belirli bir kitabın Google Kitaplar dizininde yer almaması veya önizlemenin ilgili coğrafi konumda bulunan bir kullanıcı tarafından erişilememesi gibi durumlar olabilir. Statik bağlantılar "kör" olduğundan bazen istenen etkiyi yaratamaz.

Dinamik Bağlantılar, bir kitabın görüntülenebilirliğini JavaScript kullanarak sorgulamak için alternatif, programatik istemci tarafı yöntemi sağlar. Bu yaklaşım, Kitap Arama'ya daha güvenilir ve tahmin edilebilir bağlantılar ekleyerek kullanıcılarınız için daha tutarlı bir deneyim sağlar. Görüntülenebilirlik, son kullanıcının konumuna göre değişiklik gösterdiğinden, dinamik bağlantı arayüzü sunucu tarafı veya çevrimdışı sorgular için tasarlanmamıştır.

Dynamic Links'in neler yapabileceğini anlamak için bu dokümanın sonundaki kod örneklerine geçin.

Markalama kuralları

Dinamik Bağlantılar'ı oluştururken Google Books API Ailesi'nin tabi olduğu marka bilinci oluşturma kurallarına uymanız gerekir. Özellikle,

İlişkilendirmenin ve Google Kitaplar'ın bağlantılarını korumanız gerekir.
Google Kitaplar'da önizlemelere bağlanırken yalnızca onaylı Google Önizleme düğmesini kullanmanız gerekir.
Metin bağlantıları, düğmeler, belgeler veya açıklayıcı metinler, onaylanmış adlandırma kurallarına uygun olmalıdır. Örneğin, Google Kitaplar önizlemelerine bağlantı oluştururken "indir" veya "okundu" fiillerini kullanmamanız gerekir, çünkü yalnızca herkese açık çalışmaların tamamı indirilebilir.

Örnek marka bilinci oluşturma

Freakonomics: Rogue Economist, Her şeyin Gizli tarafını Keşfediyor

Yayınlayan: Stephen Levitt ve Stephen Dubner

Bu dokümanın sonundaki örnekler bölümünde, mevcut markalama yönergelerine uygun ek örnekler verilmiştir.

İstemci tarafı API'si

İstemci tarafı dinamik bağlantının merkezinde, geliştiricilerin bir veya daha fazla kitapla ilgili bilgi isteyen URL'ler oluşturmasına ve istekleri <script> etiketini kullanarak Google Kitaplar'a göndermesine olanak tanıyan bir URL biçimi bulunur.

Söz Dizimi Örneği:: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

İstek biçimi

URL'nin biçimi, kitaplara bağlantı oluşturmak için kullanılan URL söz dizimine benzer. Ancak kitap kimliği alanında birden fazla virgülle ayrılmış kitap kimliği bulunabilir. Ayrıca #&39;jscmd' ve 'callback' parametreleri de bulunabilir. İsteğe bağlı olarak, görüntülenebilirlik filtrelerini kontrol etmek için ek bağımsız değişkenler bulunabilir.

Dinamik Bağlantılar, kitapları tanımlamak için kullanılan farklı yöntemleri destekler: ISBN'ler, OCLC numaraları ve LCCN anahtarları. API, bir GET isteğinin maksimum boyutuna kadar toplu sorgulara olanak tanır.

ISBN: &bibkeys=ISBN:0451526538 (API, ISBN 10 ve 13'ü destekler.)
OCLC'ler: &bibkeys=OCLC:36792831
LCCN: &bibkeys=LCCN:96072233

JSON sonuç biçimi

Bu çağrının yanıtı, bir veya daha fazla JSON nesnesi olarak döndürülen istenen kitaplar hakkında bilgi olacaktır. JSON nesneleri aşağıdaki yapıyı kullanır:

JsonSearchResult {
    string bib_key;
    string info_url;
    string preview_url;
    string thumbnail_url;
    string preview;
};

Bu alanlar aşağıdaki bilgileri sağlar:

bib_key: Bu kitabı sorgulamak için kullanılan tanımlayıcı.
bilgi_url'si: Google Kitaplar'daki, kitapla ilgili bilgilerin yer aldığı bir sayfanın (bu kitap hakkında sayfası) URL'si.
önizleme_url'si: Kitabın önizlemesinin URL'si, kullanıcıyı doğrudan kitabın kapağına yönlendirir. Bir istek için yalnızca Snippet Görünümü veya Önizleme Yok kitapları varsa önizleme URL'si döndürülmez.
küçük resim_url: Kitabın kapağının küçük resminin URL'si.
önizleme: Kitabın görüntülenebilirlik durumunu belirten bir değer: full (Tam Görünüm kitapları için), partial (Sınırlı Önizlemeli kitaplar için) veya noview (Snippet veya Önizlemesiz Kitaplar için).
yerleştirilebilir: Kitabın Kitap Arama yerleşik görüntüleyici kullanılarak üçüncü taraf sayfalarına yerleştirilebilirse bu boole true olur.

Dynamic Links

İçindekiler

Kitle

Kitap Arama terminolojisi

Giriş

Markalama kuralları

Örnek marka bilinci oluşturma

İstemci tarafı API'si

İstek biçimi

JSON sonuç biçimi

Parametreler ve ek alanlar

Eşzamanlı ve eşzamansız mod

Eşzamansız mod

Eşzamanlı mod

Sık sorulan sorular

Kod örnekleri