Wizard Pratinjau

Wizard Pratinjau didesain untuk memungkinkan Anda mengintegrasikan pratinjau dengan cepat, mudah, dan andal dengan situs Anda. Anda dapat menyematkan penampil buku, menautkan ke Penelusuran Buku, atau bahkan menambahkan jendela "jendela pop-up" ke situs Anda—yang perlu Anda lakukan adalah membuat kode dan menempelkannya ke halaman. Anda juga dapat menyesuaikan kode ini menggunakan beberapa fungsi JavaScript sederhana.


Wizard Pratinjau adalah library praktis sederhana yang kami buat di atas API Dynamic Links dan Embedded Viewer. Jika Anda seorang developer tingkat lanjut yang mencari integrasi yang disesuaikan, pertimbangkan untuk menggunakan API dasar secara langsung.

Membuat kode pratinjau

Contoh pratinjau yang dibuat

Contoh berikut dibuat menggunakan Wizard Pratinjau.

Menyesuaikan kode Anda

Selain menggunakan wizard di atas, Anda dapat memanggil beberapa fungsi "helper" JavaScript sederhana secara langsung. Untuk melakukan ini, Anda harus memuat library Wizard Pratinjau terlebih dahulu. Salah satu cara untuk melakukannya adalah dengan menambahkan tag berikut ke bagian <head> di halaman Anda:

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

Setelah memuat library pratinjau, Anda kemudian dapat memanggil salah satu fungsi berikut dari dalam tag <script> di dalam <body> dokumen Anda. Misalnya, jika Anda ingin menyisipkan tombol "Pratinjau Google", Anda akan menempatkan kode untuk melakukannya dalam elemen <script> pada posisi tombol yang diinginkan dalam halaman.

GBS_setBahasa

GBS_setLanguage(languageCode)
    Mengubah bahasa tombol atau teks yang ditambahkan setelah fungsi ini dipanggil. Ini termasuk bahasa tombol "Pratinjau Google", bahasa antarmuka pratinjau tersemat, dan sebagainya.
    Parameter:
      string languageCode - Kode bahasa RFC 3066 yang diinginkan (defaultnya adalah 'en' untuk bahasa Inggris). Kode bahasa yang saat ini didukung termasuk 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, ptru

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    Parameter:
      Object optionsObj - Kumpulan key-value pair yang diteruskan ke DefaultViewer konstruktor Embedded Viewer API. Biasanya, hal ini digunakan untuk penyesuaian lanjutan.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Ditujukan untuk digunakan oleh penerbit dalam Program Partner, fungsi ini menetapkan situs Penelusuran Bersama Bermerek yang akan digunakan saat menyisipkan link pratinjau apa pun ke Penelusuran Buku. Memanggil fungsi ini sebelum menyisipkan tombol akan memastikan bahwa pengguna melihat logo partner di atas pratinjau Penelusuran Buku.
    Parameter:
      string cobrandName - Nama merek bersama yang akan ditambahkan ke URL Penelusuran Buku apa pun. Ini biasanya muncul setelah /p/ di URL pratinjau Penelusuran Co-Bermerek yang sudah ada.

      Misalnya, menetapkan nilai ke sup akan mengirim pengguna ke link seperti
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      , bukan default
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Menyisipkan pratinjau buku tersemat di mana pun fungsi ini dipanggil. Jika pratinjau tidak tersedia, tidak ada penonton yang ditampilkan.
    Parameter:
      Number opt_width - Lebar penonton yang diinginkan, dalam piksel.
      Number opt_height - Tinggi penonton yang diinginkan, dalam piksel.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Jika pratinjau buku tersedia, fungsi ini akan menulis tombol "Google Preview". Mengklik tombol ini akan membuka "jendela pratinjau mengambang" tepat di bagian atas halaman. Jika pratinjau tidak tersedia, tombol tidak akan digambar.

    Developer yang lebih canggih mungkin tertarik dengan Embedded Viewer API, yang digunakan secara internal oleh fungsi ini.

    Parameter:
      string, Array identifier - URL pratinjau atau ID buku seperti ISBN, nomor OCLC, atau LCCN. Lihat Format permintaan Dynamic Links. Jika mengetahui beberapa ID alternatif untuk buku, Anda dapat meneruskan array ID ini, dan tombol akan muncul jika pratinjau tersedia untuk salah satu ID tersebut. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Jika pratinjau buku tersedia, fungsi ini akan menulis tombol "Pratinjau Google" yang hanya menautkan ke halaman pratinjau buku. Secara default, link ini ditautkan ke pratinjau di Google Buku, tetapi Anda juga dapat:
    • link ke URL di situs Anda (yang seharusnya berisi penampil tersemat). Anda dapat melakukannya dengan meneruskan opsi alternativeUrl opsional.
    • link ke halaman pratinjau buku versi Co-Bermerek, jika GBS_setCobrandName dipanggil sebelum fungsi ini.
    Jika tidak ada pratinjau yang tersedia bagi pengguna, tidak ada tombol yang akan digambar pada halaman.
    Parameter:
      string, Array identifier - URL pratinjau atau ID buku seperti ISBN, nomor OCLC, atau LCCN. Lihat Format permintaan Dynamic Links. Jika mengetahui beberapa ID alternatif untuk buku, Anda dapat meneruskan array ID ini, dan tombol akan muncul jika pratinjau tersedia untuk salah satu ID tersebut.
      Object opt_options - opsional - Peta nilai nama yang digunakan untuk mengonfigurasi perilaku tombol. Saat ini ada satu opsi yang didukung: alternativeUrl. Misalnya, agar tombol Pratinjau Google ditautkan ke halaman pratinjau kustom di situs Anda, cukup teruskan hal berikut sebagai argumen kedua ke GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }