Önizleme Sihirbazı

Önizleme Sihirbazı, önizlemeleri hızlı, kolay ve güvenilir bir şekilde sitenize entegre etmenizi sağlamak amacıyla tasarlanmıştır. Bir kitap görüntüleyici yerleştirebilir, Kitap Arama'nın bağlantısını verebilir, hatta sitenize bir önizleme "pop-up" penceresi ekleyebilirsiniz. Tek yapmanız gereken kodu oluşturmak ve sayfanıza yapıştırmaktır. Bazı basit JavaScript işlevlerini kullanarak da bu kodu özelleştirebilirsiniz.


Önizleme Sihirbazı, Dinamik Bağlantılar ve Yerleşik Görüntüleyici API'lerimizin üzerine geliştirdiğimiz basit bir kullanım kitaplığıdır. Özelleştirilmiş entegrasyon arayan ileri düzey bir geliştiriciyseniz doğrudan temel API'leri kullanabilirsiniz.

Önizleme kodunuzu oluşturun

Oluşturulan önizleme örnekleri

Aşağıdaki örnekler Önizleme Sihirbazı kullanılarak oluşturulmuştur.

Kodunuzu özelleştirin

Yukarıdaki sihirbazı kullanmaya ek olarak, bazı basit JavaScript "yardımcı" işlevlerini de doğrudan çağırabilirsiniz. Bunu yapmak için önce Önizleme Sihirbazı kitaplığını yüklemeniz gerekir. Bunu yapmanın bir yolu, aşağıdaki etiketi sayfanızın <head> bölümüne eklemektir:

<script type="text/javascript" src="https://books.google.com/books/previewlib.js"></script>

Önizleme kitaplığını yükledikten sonra, dokümanınızın <body> içindeki <script> etiketlerinden aşağıdaki işlevlerden herhangi birini çağırabilirsiniz. Örneğin, "Google Önizleme" düğmesini eklemek istiyorsanız kodu, sayfada düğmenin istediğiniz konumundaki bir <script> öğesine yerleştirirsiniz.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Bu işlev çağrıldıktan sonra eklenen düğmelerin veya metnin dilini değiştirir. Buna "Google Önizleme" düğmesinin dili, yerleştirilmiş önizlemenin arayüz dili vb. dahildir.
    Parametreler:
      string languageCode - İstenen RFC 3066 dil kodu (İngilizce için varsayılan değer "en"dir). Şu anda desteklenen dil kodları arasında şunlar yer alır: hy, bg, ca, zh-CN, zh-TW, hr, cs, da, nl, en, fil, fi, fr, de, el, hi, hu, is, id, in, it, ja, ko, lv, lt, no, pl, pt-BR, pt-PT, ro., pt-PT, ro

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    Parametreler:
      Object optionsObj - Embedded Viewer API'sinin DefaultViewer oluşturucusuna aktarılan bir anahtar/değer çifti kümesi. Genellikle bu gelişmiş özelleştirmeler için kullanılır.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    İş Ortağı Programı'ndaki yayıncılar tarafından kullanılmak üzere tasarlanmış bu işlev, Kitap Arama'ya önizleme bağlantıları eklerken kullanılacak Ortak Markalı Arama sitesini ayarlar. Bir düğme eklemeden önce bu işlevi çağırmak, kullanıcıların Kitap Arama önizlemelerinin üzerinde ortak logosunu görmelerini sağlar.
    Parametreler:
      string cobrandName - Herhangi bir Kitap Arama URL'sine eklenecek ortak marka adı. Bu genellikle mevcut Ortak Markalı Arama önizleme URL'lerinde /p/ ifadesinden sonra gelen addır.

      Örneğin, değer sup olarak ayarlandığında kullanıcı varsayılan yerine
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      gibi bağlantılara gönderilir
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Bu işlevin çağrıldığı yere yerleştirilmiş bir kitap önizlemesi ekler. Önizleme kullanılamıyorsa hiçbir izleyici gösterilmez.
    Parametreler:
      Number opt_width - İzleyicinin piksel cinsinden istenen genişliği.
      Number opt_height - İzleyicinin piksel cinsinden istenen yüksekliği.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Kitap önizlemesi kullanılabiliyorsa bu işlev bir "Google Önizleme" düğmesi yazar. Bu düğmeyi tıkladığınızda sayfanızın sağ üst kısmında bir "kayan önizleme penceresi" açılır. Önizleme yoksa düğme çizilmez.

    Daha ileri düzey geliştiriciler, bu işlevin dahili olarak kullandığı Yerleşik Görüntüleyici API'si ile ilgilenebilir.

    Parametreler:
      string, Array identifier : ISBN, OCLC veya LCCN numarası gibi bir önizleme URL'si veya kitap tanımlayıcısı. Dinamik Bağlantı istek biçimi konusuna bakın. Kitap için birkaç alternatif tanımlayıcı biliyorsanız bu tanımlayıcılardan bir dizi aktarabilirsiniz. Bu tanımlayıcılardan herhangi biri için önizleme varsa düğme görünür. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Kitap önizlemesi kullanılabiliyorsa bu işlev bir "Google Önizleme" düğmesi yazar. Bu düğme, kitabın önizleme sayfasına bağlantı verir. Varsayılan olarak, bu seçenek Google Kitaplar'daki önizlemeye bağlantı verir, ancak şunları da yapabilirsiniz:
    • sitenizdeki bir URL'ye bağlantı vermelidir (bununla birlikte, yerleşik bir görüntüleyici bulunmalıdır). Bunu, isteğe bağlı bir alternativeUrl seçeneği ileterek yapabilirsiniz.
    • GBS_setCobrandName bu işlevden önce çağrılırsa, kitap önizleme sayfasının Ortak Markalı sürümüne bağlantı verir.
    Kullanıcı için önizleme yoksa sayfaya herhangi bir düğme çizilmez.
    Parametreler:
      string, Array identifier : ISBN, OCLC veya LCCN numarası gibi bir önizleme URL'si veya kitap tanımlayıcısı. Dinamik Bağlantı istek biçimi konusuna bakın. Kitap için birkaç alternatif tanımlayıcı biliyorsanız bu tanımlayıcılardan bir dizi aktarabilirsiniz. Bu tanımlayıcılardan herhangi biri için önizleme varsa düğme görünür.
      Object opt_options - isteğe bağlı - Düğmenin davranışını yapılandırmak için kullanılan bir ad-değer eşlemesi. Şu anda bir seçenek desteklenmektedir: alternativeUrl. Örneğin, Google Önizleme düğmesi ile sitenizdeki özel bir önizleme sayfası arasında bağlantı oluşturmak için aşağıdaki kodu ikinci bağımsız değişken olarak GBS_insertPreviewButtonLink öğesine iletmeniz yeterlidir:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }