预览向导

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


预览向导是我们基于 Dynamic Links 和 嵌入式查看器 API 构建的简单便捷库。如果您是需要自定义集成的高级开发者，不妨考虑直接使用底层 API。

生成预览代码

生成的预览的示例

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

自定义代码

除了使用上述向导外，您还可以直接调用一些简单的 JavaScript“帮助程序”函数。为此，您应先加载预览向导库。一种方法是将以下代码添加到页面的 <head> 部分：

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

加载预览库后，您可以从文档的 <body> 内的 <script> 标记内调用以下任一函数。例如，如果您想插入“Google 预览”按钮，需要将相关代码插入 <script> 元素中按钮的理想位置。

GBS_设置语言

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-BR、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt、pt

GBS_设置查看者选项

GBS_setViewerOptions(optionObj)
    参数：
      Object optionsObj - 传递给 Embedded Viewer API 的 DefaultViewer 构造函数的一组键值对。通常，它用于高级自定义。

GBS 集品牌名称

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_插入嵌入式查看器

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 编号。请参阅动态链接请求格式。如果您知道该图书的多个备用标识符，则可以传递这些标识符的数组，当其中任一标识符可供预览时就会显示该按钮。 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    如果提供图书预览，此函数会写出“Google 预览”按钮，该按钮仅链接到图书试阅页面。默认情况下，此链接指向 Google 图书上的试阅，不过您也可以：
    • 链接到您网站上的某个网址（这反过来又应包含一个嵌入式查看器）。为此，您可以传递可选的 alternativeUrl 选项。
    • 指向图书预览页的联合品牌版本的链接（如果在调用此函数之前调用了 GBS_setCobrandName）。
    如果用户无法预览，则不会在页面上绘制任何按钮。
    参数：
      string, Array identifier - 试阅网址或图书标识符，例如 ISBN、OCLC 或 LCCN 编号。请参阅动态链接请求格式。如果您知道该图书的多个备用标识符，则可以传递这些标识符的数组，当其中任一标识符可供预览时就会显示该按钮。
      Object opt_options - 可选 - 用于配置按钮行为的名称值映射。目前仅支持 alternativeUrl 这一选项。例如，如需使 Google 预览按钮链接到您网站上的自定义预览页面，只需将以下内容作为第二个参数传递给 GBS_insertPreviewButtonLink：
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }