Önizleme Sihirbazı

Önizleme Sihirbazı, önizlemeleri sitenizle hızlı, kolay ve güvenilir bir şekilde entegre edebilmeniz için tasarlanmıştır. Kitap görüntüleyici yerleştirebilir, Kitap Arama'ya bağlantı oluşturabilir, hatta sitenize bir önizleme "pop-up" penceresi ekleyebilirsiniz. Bunun için kodu oluşturup sayfanıza yapıştırmanız yeterlidir. Ayrıca, bazı basit JavaScript işlevlerini kullanarak bu kodu özelleştirebilirsiniz.


Önizleme Sihirbazı, Dinamik Bağlantılar ve Yerleşik Görüntüleyici API'lerimiz temelinde oluşturduğumuz basit bir kolaylık kitaplığıdır. Özelleştirilmiş entegrasyon arayan bir ileri düzey geliştiriciyseniz doğrudan alttaki API'leri kullanabilirsiniz.

Önizleme kodunuzu oluşturma

Oluşturulan önizleme örnekleri

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

Kodunuzu özelleştirin

Yukarıdaki sihirbazı kullanmaya ek olarak, bazı basit JavaScript "yardımcı" işlevlerini 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> etiketleri içinde aşağıdaki işlevlerden herhangi birini çağırabilirsiniz. Örneğin, "Google Önizleme" düğmesini eklemek istiyorsanız bu işlemi için gereken kodu, düğmenin sayfada istediğiniz konuma gelecek şekilde bir <script> öğesine yerleştirin.

GBS_setDil

GBS_setLanguage(languageCode)
    Bu işlev çağrıldıktan sonra, eklenen düğmelerin veya metnin dilini değiştirir. Bunlara "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 "en"dir). Şu anda desteklenen dil kodları arasında şunlar bulunur: 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-r, r, r

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    Parametreler:
      Object optionsObj - Yerleşik Görüntüleyici API'sinin DefaultViewer oluşturucuya aktarılan anahtar/değer çiftleri grubu. Bu, genellikle 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 tasarlanan bu işlev, Kitap Arama'ya önizleme bağlantıları eklerken kullanılacak Ortak Markalı Arama sitesini ayarlar. Düğme eklemeden önce bu işlevi çağırmak, kullanıcıların Kitap Arama önizlemelerinin üzerinde iş ortağının logosunu görmesini sağlar.
    Parametreler:
      string cobrandName - Kitap Arama URL'lerine eklenecek ortak marka adı. Bu ad, genellikle mevcut Ortak Markalı Arama önizleme URL'lerinde /p/ karakterinden sonra gelen kısımdır.

      Örneğin, değeri sup olarak ayarlamak, kullanıcıyı varsayılan seçenek yerine
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      gibi bağlantılara yönlendirir
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertYerleşik Görünüm

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Bu işlevin adı her yerde yerleşik bir kitap önizlemesi ekler. Önizleme kullanılamıyorsa izleyici gösterilmez.
    Parametreler:
      string identifier - ISBN, OCLC veya LCCN numarası gibi bir önizleme URL'si veya kitap tanımlayıcısı. Dinamik Bağlantı istek biçimi başlıklı makaleye bakın.
      Number opt_width - Görüntüleyenin piksel cinsinden istenen genişliği.
      Number opt_height - Görüntüleyenin piksel cinsinden istenen yüksekliği.

GBS_insertÖnizlemeDüğmesi Popup'ı

GBS_insertPreviewButtonPopup(identifiers)
    Kitap önizlemesi kullanılabiliyorsa bu işlev, bir "Google Önizleme" düğmesi yazar. Bu düğme tıklandığında, sayfanızın hemen üzerinde bir "kayan önizleme penceresi" açılır. Önizleme yoksa düğme çizilemez.

    Daha gelişmiş geliştiriciler, bu işlevin dahili olarak kullandığı Yerleşik Görüntüleyici API'si ile ilgileniyor olabilir.

    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 başlıklı makaleye bakın. Kitap için birden fazla alternatif tanımlayıcı biliyorsanız, bu tanımlayıcıların sırasını iletebilirsiniz. Bu tanımlayıcılardan herhangi biri için önizleme varsa düğme görüntülenir. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Kitap önizlemesi kullanılabiliyorsa bu işlev, yalnızca kitabın önizleme sayfasına yönlendiren bir "Google Önizleme" düğmesi yazar. Bu, varsayılan olarak Google Kitaplar'daki önizlemeye bağlantı verir ancak şunları da yapabilirsiniz:
    • Sitenizdeki bir URL'ye bağlantı verme (sırasıyla, yerleşik bir izleyici içerir). Bunu, isteğe bağlı bir alternativeUrl seçeneği ileterek yapabilirsiniz.
    • Bu işlevden önce GBS_setCobrandName çağrılırsa kitap önizleme sayfasının ortak markalı bir sürümüne bağlantı verin.
    Kullanıcı herhangi bir önizleme içermiyorsa sayfada 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 başlıklı makaleye bakın. Kitap için birden fazla alternatif tanımlayıcı biliyorsanız, bu tanımlayıcıların sırasını iletebilirsiniz. Bu tanımlayıcılardan herhangi biri için önizleme varsa düğme görüntülenir.
      Object opt_options - isteğe bağlı - Düğmenin davranışını yapılandırmak için kullanılan bir ad-değer haritası. Şu anda bir seçenek destekleniyor: alternativeUrl. Örneğin, Google Önizleme düğmesinin sitenizde özel bir önizleme sayfasına bağlanması için GBS_insertPreviewButtonLink öğesine ikinci bağımsız değişken olarak aşağıdakileri göndermeniz yeterlidir:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }