此页面由 Cloud Translation API 翻译。

Dynamic Links

借助 Google 图书动态链接功能，您可以创建更加可自定义、可靠的链接，以便从自己的网站指向 Google 图书。例如，您可以利用此工具生成“智能”链接（仅当图书编入我们的索引时才显示），或生成一些链接，向用户指明图书是否可以在 Google 图书上试阅。通过动态链接功能，您还可以在指向 Google 图书的链接中添加缩略图。本文档旨在帮助您快速将此功能添加到您的网站。

注意：此功能以前称为 Book Viewability API。

预览向导是一款基于动态链接构建的工具，可让您更轻松地从网站链接到图书预览，只需复制几行代码即可。本文档适用于希望自定义其图书搜索链接方式的更高级开发者。

观众

动态链接文档适用于要编写链接到 Google 图书中图书的网络应用的程序员。本文档假定您熟悉 HTTP 协议和基本 JavaScript。

图书搜索术语

Google 图书尊重用户当地的版权限制，因此某些图书的试阅或全书浏览功能仅在部分地区提供。可见度划分为以下类：

全屏视图: 整本图书均可查看。这些图书可能属于公共领域。
有限预览: 图书的一部分内容可供查看。此图书受版权保护，Google 图书已获得相应的授权，允许用户访问这些书页。此类图书与“摘录视图”图书的不同之处在于，用户可以查看整页内容。
摘要视图和无预览: 用户只会看到“图书信息”页面。最多只能提供图书中的简短摘录。此图书尚未被扫描，或者受版权保护且 Google 图书尚未获得显示与用户搜索字词相关的多个“片段”的许可。

简介

静态链接文档介绍了一种非常简单的方法，可生成指向 Google 图书上特定图书页面的网址。遗憾的是，有时可能会发生这样的情况：特定图书未编入 Google 图书索引，或特定地理位置的用户无法预览。由于静态链接是“盲目”的，因此它们有时无法产生预期效果。

动态链接提供了一种备选的程序化客户端方法，可让您使用 JavaScript 查询图书的可见度。这样，您就可以加入更加可靠且可预测的图书搜索链接，从而为用户提供更加一致的体验。由于可见度因最终用户所在的位置而异，因此动态链接界面不适用于服务器端或离线查询。

要了解动态链接的功能，请跳至本文末尾的代码示例。

品牌推广指南

呈现动态链接时，您必须遵守 Google Books API 系列规定的品牌推广指南。具体而言，

您必须保留指向 Google 图书的出处和链接。
链接到 Google 图书上的试阅时，您只能使用已获批准的 Google 预览按钮。
所有文本链接、按钮、文档或说明性文字均应符合已获批准的命名惯例。例如，在链接到 Google 图书预览时，不应使用动词“download”（下载）或“read”（阅读），因为只有属于公共领域的作品才能完整下载。

品牌信息示例

《Freakonomics: An Rogue Economist》（《Freakonomics: An Rogue Economist》（流氓经济学家）探索隐藏的一切）

作者：Steven Levitt 和 Stephen Dubner

本文档末尾的“示例”部分提供了符合当前品牌推广指南的其他示例。

客户端 API

客户端动态链接的核心是网址格式，开发者可以通过该网址构建网址来请求一本或多本图书的相关信息，并使用 <script> 标记向 Google 图书发送请求。

语法示例：: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

请求格式

网址格式类似于用于链接到图书的网址语法，但图书 ID 字段可以包含多个用逗号分隔的图书 ID，并且还有其他“jscmd”和“callback”参数。您还可以选择提供其他参数来控制可见度过滤条件。

Dynamic Links 支持多种不同的图书标识方法：ISBN、OCLC 编号和 LCCN 键。该 API 允许最多达到 GET 请求大小上限的批量查询。

ISBN: &bibkeys=ISBN:0451526538（API 支持 ISBN 10 和 13。）
OCLC: &bibkeys=OCLC:36792831
伦敦证券交易委员会: &bibkeys=LCCN:96072233

JSON 结果格式

此调用的响应将是与所请求图书相关的信息，以一个或多个 JSON 对象的形式返回。JSON 对象使用以下结构：

JsonSearchResult {
    string bib_key;
    string info_url;
    string preview_url;
    string thumbnail_url;
    string preview;
};

这些字段提供以下信息：

bib_key: 用于查询此图书的标识符。
info_url: 指向 Google 图书中包含图书信息的页面（即“图书信息”页面）的网址。
preview_url: 指向图书预览的网址，用户点击后可以直接转到图书的封面。如果请求只能提供“摘录视图”或“不提供试阅”图书，则系统不会返回试阅网址。
thumbnail_url: 指向图书封面缩略图的网址。
预览版: 一个值，用于指示图书的可见状态：full（对于全书浏览的图书）、partial（对于小范围预览图书）或 noview（对于摘录或不提供试阅的图书）。
嵌入式: 如果图书可以使用嵌入式阅读器嵌入到第三方网页中，则此布尔值为 true。

Dynamic Links

目录

观众

图书搜索术语

简介

品牌推广指南

品牌信息示例

客户端 API

请求格式

JSON 结果格式

参数和其他字段

同步与异步模式

异步模式

同步模式

常见问题解答

代码示例