Wizard Pratinjau

Wizard Pratinjau dirancang untuk memungkinkan Anda mengintegrasikan pratinjau dengan situs Anda dengan cepat, mudah, dan andal. Anda dapat menyematkan penampil buku, menautkan ke Penelusuran Buku, atau menambahkan jendela "pop-up" pratinjau ke situs—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 kembangkan berdasarkan Dynamic Links dan Embedded Viewer API. Jika Anda adalah developer tingkat lanjut yang mencari integrasi yang disesuaikan, pertimbangkan untuk menggunakan API dasar secara langsung.

Membuat kode pratinjau

Contoh pratinjau yang dihasilkan

Contoh berikut dibuat menggunakan Wizard Pratinjau.

Menyesuaikan kode

Selain menggunakan wizard di atas, Anda dapat mengaktifkan beberapa fungsi "helper" JavaScript sederhana secara langsung. Untuk melakukannya, 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. Misalnya, jika ingin menyisipkan tombol "Pratinjau Google", Anda harus menempatkan kode untuk melakukannya dalam elemen <script> pada posisi tombol yang diinginkan dalam halaman.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Mengubah bahasa tombol atau teks apa pun yang ditambahkan setelah fungsi ini dipanggil. Ini mencakup bahasa tombol "Pratinjau Google", bahasa antarmuka pratinjau tersemat, dan sebagainya.
    Parameter:
      string languageCode - Kode bahasa RFC 3066 yang diinginkan (default-nya adalah 'en' untuk bahasa Inggris). Kode bahasa yang didukung saat ini meliputi 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, pl, pt-BR, pt-PT, pl.

GBS_setViewerOptions

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

GBS_setCobrandName

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

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

GBS_insertEmbeddedViewer

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

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Jika pratinjau buku tersedia, fungsi ini akan menulis tombol "Pratinjau Google". Mengeklik tombol ini akan membuka "jendela pratinjau mengambang" tepat di bagian atas laman. Jika tidak ada pratinjau yang tersedia, tombol tidak akan digambar.

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

    Parameter:
      string, Array identifier - URL pratinjau atau ID buku seperti nomor ISBN, OCLC, atau LCCN. Lihat Format permintaan Dynamic Links. Jika Anda mengetahui beberapa ID alternatif untuk buku tersebut, Anda dapat meneruskan array ID ini, dan tombol tersebut akan muncul jika pratinjau tersedia untuk salah satunya. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Jika pratinjau buku tersedia, fungsi ini akan menuliskan tombol "Pratinjau Google" yang langsung menautkan ke halaman pratinjau untuk buku tersebut. Secara default, link ini akan ditautkan ke pratinjau di Google Buku, tetapi Anda juga dapat:
    • tertaut 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-Brand, jika GBS_setCobrandName dipanggil sebelum fungsi ini.
    Jika tidak ada pratinjau yang tersedia untuk pengguna, tidak ada tombol yang akan digambar di halaman.
    Parameter:
      string, Array identifier - URL pratinjau atau ID buku seperti nomor ISBN, OCLC, atau LCCN. Lihat Format permintaan Dynamic Links. Jika Anda mengetahui beberapa ID alternatif untuk buku tersebut, Anda dapat meneruskan array ID ini, dan tombol tersebut akan muncul jika pratinjau tersedia untuk salah satunya.
      Object opt_options - opsional - Peta nilai nama yang digunakan untuk mengonfigurasi perilaku tombol. Saat ini satu opsi didukung: alternativeUrl. Misalnya, agar tombol Pratinjau Google ditautkan ke halaman pratinjau kustom di situs Anda, cukup teruskan argumen berikut sebagai argumen kedua ke GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }