预览向导

预览向导旨在帮助您快速、轻松、可靠地将预览与您的网站集成。您可以嵌入图书查看器、链接到图书搜索，甚至可以向您的网站添加预览“弹出式窗口”窗口，您只需生成代码并将其粘贴到您的网页中即可。您还可以使用一些简单的 JavaScript 函数来自定义此代码。


预览向导是一个简单的便捷库，我们以 Dynamic Links 和 Embedded Viewer API 为基础构建而成。如果您是需要自定义集成的高级开发者，请考虑直接使用底层 API。

生成预览代码

生成的预览示例

以下示例是使用预览向导生成的。

自定义您的代码

除了使用上面的向导，您还可以直接调用一些简单的 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-ru

GBS_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(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' }