预览向导旨在帮助您快速、轻松、可靠地将预览与您的网站集成。您可以嵌入图书查看器、链接到图书搜索,甚至可以向您的网站添加预览“弹出式窗口”窗口,您只需生成代码并将其粘贴到您的网页中即可。您还可以使用一些简单的 JavaScript 函数来自定义此代码。
预览向导是一个简单的便捷库,我们以 Dynamic Links 和 Embedded Viewer API 为基础构建而成。如果您是需要自定义集成的高级开发者,请考虑直接使用底层 API。
生成预览代码
生成的预览示例
以下示例是使用预览向导生成的。
- previewwizard-embed:在网页上嵌入图书查看器。
- previewwizard-popup:添加一个按钮,点击此按钮即可在网页上打开浮动预览。
- previewwizard-linktogbs:插入一个链接到图书搜索网站上的预览的按钮。
- previewwizard-customurl:显示可转到特定网址的按钮。
自定义您的代码
除了使用上面的向导,您还可以直接调用一些简单的 JavaScript“帮助程序”函数。为此,您应首先加载预览向导库。一种方法是将以下代码添加到网页的 <head>
部分:
<script type="text/javascript" src="https://books.google.com/books/previewlib.js"></script>
加载预览库后,您可以从文档的 <body>
内的 <script>
标记内调用以下任一函数。例如,如果您要插入“Google 预览”按钮,则需要将代码放置在 <script>
元素中,并将其放在页面中该按钮的所需位置。
GBS_setLanguage
GBS_setLanguage(languageCode)
-
用于更改在调用此函数后添加的任何按钮或文本的语言。其中包括“Google 预览”按钮的语言、嵌入的预览的界面语言等。
-
参数:
string languageCode
- 所需的 RFC 3066 语言代码(英语默认为“en”)。目前支持的语言代码包括 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-uk、pt-BR、pt-ruGBS_setViewerOptions
GBS_setViewerOptions(optionObj)
-
参数:
Object optionsObj
- 一组传递给 Embedded Viewer API 的 DefaultViewer 构造函数的键值对。通常,此配置用于高级自定义。GBS_setCobrandName
GBS_setCobrandName(cobrandName)
-
参数:
string cobrandName
- 要添加到任何图书搜索网址的联合品牌名称。在现有的联合品牌搜索预览网址中,它通常位于 /p/
之后。
例如,将该值设置为 sup
会将用户转到
https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
等链接,而不是默认的
https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover
GBS_insertEmbeddedViewer
GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
-
在调用此函数的位置插入嵌入式图书预览。如果无法预览,则系统不会显示任何查看器。
-
参数:
string identifier
- 试阅网址或图书标识符,例如 ISBN、OCLC 或 LCCN 编号。请参阅 Dynamic Links 请求格式。
Number opt_width
- 所需的查看器宽度(以像素为单位)。
Number opt_height
- 查看器所需的高度(以像素为单位)。
GBS_insertPreviewButtonPopup
GBS_insertPreviewButtonPopup(identifiers)
-
如果可以预览图书,此函数会输出“Google 预览”按钮。点击此按钮后,网页上方将打开一个“浮动预览窗口”。如果没有可用的预览,系统便不会绘制该按钮。
更成熟的开发者可能会对此函数在内部使用的 Embedded Viewer API 感兴趣。
-
参数:
string, Array identifier
- 试阅网址或图书标识符,例如 ISBN、OCLC 或 LCCN 编号。请参阅 Dynamic Links 请求格式。如果您知道该图书的多个替代标识符,可以传递一组这些标识符,当其中任何一个标识符可供预览时,系统就会显示相应按钮。
GBS_insertPreviewButtonLink
GBS_insertPreviewButtonLink(identifiers, opt_options)
-
如果可以进行图书预览,则此函数会写出“Google 预览”按钮,点击该按钮会直接链接到相应图书的预览页面。默认情况下,此链接会链接到 Google 图书上的试阅部分,但您也可以:
- 指向您网站上某个网址(其中应该包含一个嵌入式查看器)的链接。为此,您可以传递可选的
alternativeUrl
选项。 - 会链接到图书预览页的联合品牌版本(前提是在此函数之前调用了 GBS_setCobrandName)。
-
参数:
string, Array identifier
- 试阅网址或图书标识符,例如 ISBN、OCLC 或 LCCN 编号。请参阅 Dynamic Links 请求格式。如果您知道该图书的多个替代标识符,可以传递一组这些标识符,当其中任何一个标识符可供预览时,系统就会显示相应按钮。
Object opt_options
- 可选 - 用于配置按钮行为的名称值映射。目前支持一种选项:alternativeUrl
。例如,如需将“Google 预览”按钮链接到您网站上的自定义预览页面,只需将以下内容作为第二个参数传递给 GBS_insertPreviewButtonLink
即可: { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }