Wizard Pratinjau
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
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(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' }
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-06-28 UTC.
[null,null,["Terakhir diperbarui pada 2024-06-28 UTC."],[],[],null,["# Preview Wizard\n\nThe Preview Wizard is designed to let you quickly, easily, and reliably integrate previews with your site. You can embed a book viewer, link to Book Search, or even add a preview \"popup\" window to your site---all you need to do is [generate the code](#generateCode) and paste it onto your page. You can also [customize this code](#customizeYourCode) using some simple JavaScript functions.\n\nThe Preview Wizard is a simple convenience library we built on top of our [Dynamic Links](/books/docs/dynamic-links) and [Embedded Viewer](/books/docs/viewer/developers_guide) APIs. If you're an advanced developer looking for customized integration, consider\nusing the underlying APIs directly.\n\nGenerate your preview code\n--------------------------\n\n#### Enter book identifiers\n\nTell us all the ISBNs or other identifiers you know of for this book. If we can find a preview associated with any of these numbers, we can make it available to your site's users:\n\n|--------------------------------------|---|\n| ISBN OCLC number LCCN Book Search ID | |\n| ISBN OCLC number LCCN Book Search ID | |\n| ISBN OCLC number LCCN Book Search ID | |\n\n[Enter more identifiers...](about:invalid#zGoSafez)\n\n#### Choose how to show the book preview\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| If a preview is available for this book, what should the user see on your page? |---|------------------------------------------------------------------------| | | An embedded book viewer. Viewer size: pixels wide, pixels high | | | A button that opens a floating book viewer. | | | A button that links to the book's preview page on Book Search. | | | A button that goes to a custom preview page on your site. Preview URL: | If no preview can be found for the specified book(s), the preview or button will be automatically disabled and nothing will appear. | |\n\n#### Select your language\n\nChinese (Simplified) Chinese (Traditional) Dutch English French German Italian Japanese Portuguese (Brazilian) Russian Spanish\n\n#### Generate code for your web page\n\nExamples of generated previews\n------------------------------\n\nThe following examples were generated using the Preview Wizard.\n\n- [previewwizard-embed](/books/examples/previewwizard-embed): Embeds a book viewer on the page.\n- [previewwizard-popup](/books/examples/previewwizard-popup): Adds a button that can be clicked to open a floating preview over the page.\n- [previewwizard-linktogbs](/books/examples/previewwizard-linktogbs): Inserts a button that links to the preview on the Book Search site.\n- [previewwizard-customurl](/books/examples/previewwizard-customurl): Shows a button that goes to a specific URL.\n\nCustomize your code\n-------------------\n\nIn addition to using the wizard above, you can call some simple JavaScript \"helper\" functions directly. To do this, you should first load the Preview Wizard library. One way to do this is by adding the following tag to the `\u003chead\u003e` section of your page: \n\n```\n\u003cscript type=\"text/javascript\" src=\"https://books.google.com/books/previewlib.js\"\u003e\u003c/script\u003e\n```\n\nHaving loaded the preview library, you can then call any of the following functions from within `\u003cscript\u003e` tags inside your document's `\u003cbody\u003e`. For example, if you'd like to insert the \"Google Preview\" button, you'd put the code to do so in a `<script\u003e` element at the button's desired position within the page.\n\n### GBS_setLanguage\n\n```\nGBS_setLanguage(languageCode)\n```\n\nChanges the language of any buttons or text added after this function is called. This includes the language of the \"Google Preview\" button, the interface language of the embedded preview, and so on.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string*` languageCode ` - The desired RFC 3066 language code (default is 'en' for English). Currently supported language codes include 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, ru, sr, sk, sl, es, sv, th, tr, uk, and vi.\n\n### GBS_setViewerOptions\n\n```\nGBS_setViewerOptions(optionObj)\n```\n\n**Parameters:** *Object*` optionsObj ` - A set of key-value pairs passed to the Embedded Viewer API's [DefaultViewer constructor](/books/docs/viewer/reference#google.books.DefaultViewer). Typically, this is used for advanced customizations.\n\n### GBS_setCobrandName\n\n```\nGBS_setCobrandName(cobrandName)\n```\n\nIntended for use by publishers in the [Partner Program](https://books.google.com/partner), this function sets the [Co-Branded Search](https://books.google.com/support/partner/bin/answer.py?hl=en&answer=65113) site to be used when inserting any preview links to Book Search. Calling this function before inserting a button ensures that users see the partner's logo above the Book Search previews.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string*` cobrandName ` - The cobrand name to be added to any Book Search URLs. This is typically what comes after `/p/` in existing Co-Branded Search preview URLs.\n- For example, setting the value to `sup` will send the user to links like \n `https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover` \n rather than the default \n `https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover`\n\n### GBS_insertEmbeddedViewer\n\n```\nGBS_insertEmbeddedViewer(identifier, opt_width, opt_height)\n```\n\nInserts an embedded book preview wherever this function is called. If the preview is unavailable, no viewer is shown.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string*` identifier ` - A preview URL or book identifier such as an ISBN, OCLC, or LCCN number. See [Dynamic Links request format](/books/docs/dynamic-links#requestFormat).\n\u003c!-- --\u003e\n\n*Number*` opt_width ` - The desired width of the viewer, in pixels.\n\u003c!-- --\u003e\n\n*Number*` opt_height ` - The desired height of the viewer, in pixels.\n\n### GBS_insertPreviewButtonPopup\n\n```\nGBS_insertPreviewButtonPopup(identifiers)\n```\n\nIf the book preview is available, this function writes out a \"Google Preview\" button. Clicking this button opens a \"floating preview window\" right on top of your page. If no preview is available, the button is not drawn.\n- More sophisticated developers may be interested in the [Embedded Viewer API](/books/docs/viewer/developers_guide), which this function uses internally.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string, Array*` identifier ` - A preview URL or book identifier such as an ISBN, OCLC, or LCCN number. See [Dynamic Links request format](/books/docs/dynamic-links#requestFormat). If you know of several alternative identifiers for the book, you can pass an array of these identifiers, and the button will appear if a preview is available for any one of them.\n\n### GBS_insertPreviewButtonLink\n\n```\nGBS_insertPreviewButtonLink(identifiers, opt_options)\n```\n\nIf the book preview is available, this function writes out a \"Google Preview\" button that simply links off to a preview page for the book. By default, this links to the preview on Google Books, but you can also:\n- link to a URL on your site (which should, in turn contain an embedded viewer). You can do this by passing an optional `alternativeUrl` option.\n- link to a Co-Branded version of the book preview page, if [GBS_setCobrandName](#GBS_setCobrandName) is called before this function.\nIf no preview is available to the user, no button is drawn onto the page.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string, Array*` identifier ` - A preview URL or book identifier such as an ISBN, OCLC, or LCCN number. See [Dynamic Links request format](/books/docs/dynamic-links#requestFormat). If you know of several alternative identifiers for the book, you can pass an array of these identifiers, and the button will appear if a preview is available for any one of them.\n\u003c!-- --\u003e\n\n*Object*` opt_options ` - *optional* - A name-value map used to configure the behavior of the button. Currently one option is supported: `alternativeUrl`. For example, to have the Google Preview button link to a custom preview page on your site, simply pass the following as a second argument to `GBS_insertPreviewButtonLink`: \n` { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' } `"]]
