运用Google Ajax搜索API
掌握AJAX, 第 9部分: 运用Google Ajax搜索API
本系列英文链接：http://www-128.ibm.com/developerworks/views/web/libraryview.jsp?search_by=Mastering+Ajax
本系列中文链接：
http://www.ibm.com/developerworks/cn/web/wa-ajaxintro/
利用共公API使你的异步应用获益
developerWorks
等级: 中级
Brett McLaughlin (mailto:brett@newInstance.com?subject=Using the Google Ajax Search API&cc=htc@us.ibm.com), 作者和编辑, O'Reilly Media Inc.
2007年1月23日
创建异步请求并不仅仅只能在你自己的服务器端程序，你完全可以与公共API进行通信，例如Google 或者 Amazon的公共API。 比起使用你自己的脚本和服务器端程序来说，它们可以为你的Web应用提供更多的功能。 在这篇文章中， Brett McLaughlin将教你如何从公共API(如Google)创建请求接收响应。
迄今为止，我们的重点一直放在你的客户端Web页如何创建请求到你的服务器端脚与程序上。这大概可以让80%－90%的 Ajax 应用 -- 使用XMLHttpRequest object对象进行异步通讯的Web应用 -- 工作。但是，一个很明显且严重的局限性放在了我们的面前：你自己的想象力与编程能力毕竟是有限的，即使是在你的公司，你们的想象力或编程技巧也是有限的。
的确，在某些时候你会发现你真的想完成某些事情，但你不具备必须的技术知识来达成目标。可能是你不知道种语言的用法，也可能是如何设计出正确的算法。还有可能，你不能获得必要的信息(无论是人力资料还是数据资源)来满足你的需求。在这样的情况下，或许你就会想：“呀，要是我可以使用那些人的代码该有多好！” 如果你这样想，现在就让我来告诉你怎么做吧。
开放源码的脚本和程序
在我开始这篇文章之前 -- 在你的Web应用中使用 -- 必须要先简单介绍一下开放源码脚本与程序。 开放源码 是一组常常用来描述那些在一定的范围内可以自由地在你的Web应用中使用和重用的代码。相关 资源链接现在大概有10,000行，你可以使用别人已经完成的开放源码，只需要简单的把它们添入你的环境中，没有任何的约束或限制
如果你决定要使用开放源码，有时你必须要在你的应用中加入额外的文档，或者你决定把你的的改进贡献给开源社区。无论你如何使用这些程序，最终的结果都是：你可以使用这些代码而不必再写一遍，或者可能是那些没有足够帮助和没有足够资源你就无法写的代码。象Apache这样的工程，开发者希望能让你的工作更易于获得优势－－不必但心，他们期望你使用他们的成果！
文章及在线教程
通过internet可访问到在IBM developerWorks上发表的资源，无论是文章，还是教程，或者白皮书，均不提及它们的价值，这是一件多么愚蠢的事情。 确实有成百上千篇在线教程，你也许可以找到上百篇的关于Ajax的文章－－我就这个主题也已经写了十篇以上！绝大部分文章中有可用的代码，示例，下载，并且所有这些你都可以使用。
如果你没有能力编写你想使用的服务器端程序或代码，也可能你不能找到你需要的开放源代码程序或脚本，你可以跳到Google并键入你想寻找的简单描述。你通常都会找到应该可以帮你做到你所需要的一篇文章，技巧，或者别的在线片段。你也可以跳到developerWorks，输入同样的简单描述，这时你却能找到正确的完整代码，带有完整说明它是怎么工作的注释的完整脚本。
使用公共的API
很多时候，你会发现，你所面临的问题并不仅仅只是技术。你完全可以搞定所有的脚本和代码，可是你却没有你所需要的数据或资源。在这样的情况下，或许教程和开放源码可以帮到你，但还不够。考虑这样的一种情况,你想在你的Web页中放一个搜索引擎。假定你需要一些你要搜索的数据－－但是如果你想搜索的数据比公司或组织可提供的数据更多时怎么办？
在这种情况下，限制你的不是你的技术能力，而是数据，公共API或许可以解决你的问题。公共API允许你使用其他人的服务器的端口，使用他们的数据。通常，API自己定义你如何与你的程序互动，比如，一个Google搜索引擎的公共API可以让你提出搜索请求，但Google的代码会去搜索Google的数据，之后将结果返回给你的程序。你不仅可以受益于其他人的技术技能，而且受益于远比你或你的公司所能提供的数据贮备。
开始学习使用Google Ajax搜索API
毫无疑问，Google依然是上网应用的重要技术。80的老人和4岁的小孩子都知道Google。即使他们并不明白上网是怎么回事。它是一个非常流行和有用的搜索引擎，并且Google一直致力于提供相当多的免费服务，所以，可以在你自己的程序中使用它的公共API是毫不奇怪的。在这一章，你将学会使用Google API，为帮助你正确的理解如何创建到Google的异步应用通信作准备。
获得Google开发者ID
这篇文章将关注于Google的Ajax搜索API。访问Google Ajax搜索API主页，你可以找到更多关于这方面API的细节，图1是它的一个展示。 (参见 资源 链接 )
图 1. Google的Ajax搜索 API帮助页
Google的Ajax搜索API帮助页
你的第一步是单击Sign up for a Google AJAX Search API key链接。它将跳到一个能让你注册使用Google API的页面。你必须接受这些使用条款--说实在的，我真的觉得一点也不幽默 -- 并提供你自己的应用Web站点的URL (参见图 2).
图2. 注册Google的Ajax搜索API
Signing up for Google's Ajax Search APIn
我应该用什么URL?
Google请求你填写的URL其实就是你的站点的域名。如果你有自己的顶级域名(我就有)，那你就只需要提交http://www.newinstance.com (这是我的服务器的域名，显然，你应该换成你自己的)。如果你的站点是一个大域下的子域或者子目录，你或许需要提供象http: //www.earthlink.net/~bmclaugh 或者 http://brett.earthlink.net的URL。尽管还有其它的特殊情况，但也不要提供过度详细的URL给Google，只需要给它访问你完整Web站点的根URL就可以了。这样你可以在站点下的任何位置使用API。
一旦你读完了条例并选上了复选框，键入了你的URL，点击Generate API Key按钮并等待一到两秒。这时你必须使用你的Google账户联到Google上，或者建立一个新账户。这是很标准的过程，你可以很轻松的搞定。一旦你完成，你会得到一个正确的回复页，那上面列出了一个很长的ID，重复你的URL，甚至还提供给你一个示例代码。那个ID看上去会象这样：
ABQIAAAAjtuhyCXrSHOFSz7zK0f8phSA9fWLQO3TbB2M9BRePlYkXeAu8lHeUgfgRs0eIWUaXg
Google的 API 文档
在你使用分配给你的ID之前，你应该抽点时间去查看一下Google的API文档(在提供给你ID的那个页面的底部有一个链接，我们这篇文章的资源部分也有这个链接). 尽管通过这篇文章你也可以获得好的开始，但是你会发现Google API文档是一个好帮助，它很可能会为你独特的应用提供一些如何在你自己的站点上使用Google的有趣的主意。
最简单的Google搜索Web应用
为了让你了解究竟可以怎么做，让我们一起通过Google提供的Web示例，并做一点点修改，看看它究竟是怎么工作的。
创建一个搜索框
清单1列出了一个相当简单的Web页；把它们键入你喜欢的编辑器中，保存，并上载到你在前面一节中提供给Google的域或者URL。
清单1. 一个简单的Google搜索应用
<html>
<head>
<title>My Google AJAX Search API Application</title>
<link href="http://www.google.com/uds/css/gsearch.css"
type="text/css" rel="stylesheet" />
<script
src="http://www.google.com/uds/api?file=uds.js&v=1.0&key=在这里键入你的ID"
type="text/javascript"> </script>
<script language="Javascript" type="text/javascript">
function OnLoad() {
// 创建一个Google搜索控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
searchControl.addSearcher(localSearch);
searchControl.addSearcher(new GwebSearch());
searchControl.addSearcher(new GvideoSearch());
searchControl.addSearcher(new GblogSearch());
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
// "画"控件到HTML表单上
searchControl.draw(document.getElementById("searchcontrol"));
}
</script>
</head>
<body onload="OnLoad()">
<div id="searchcontrol" />
</body>
</html>
确认使用了你从Google上获得的开发ID替换了黑体字部分。当你下载了这个页面，你应该可以看到如图3那样的页面。
图3. 最简单的从Google进行搜索的页面
The simplest search form for Google
看上去并没有什么，但所有Google的神奇都藏匿在了小小的控件后面。
运行一个搜索
键入一个搜索条件并点击Search以提交到Google。你将很快看到如图4那样的结果弹出。
图4. Google的搜索结果
Google's search results
添加一个预搜索查询
很明显，一旦你执行了一个搜索查询，页面看上去整个都漂亮了许多；视频，博客等，搜索结果有一个比较好看的显示。因此，你或许需要添加一个 预搜索 -- 一个你自定义的搜索查询，当用户下载你的页面时，这个自定义结果将首先显示在用户的浏览器中。要做到这点，只需要在你的JavaScript中添加清单2中的加粗的那一行就够了。
清单 2. 添加一个预搜索查询
function OnLoad() {
// 创建一个Google搜索控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
searchControl.addSearcher(localSearch);
searchControl.addSearcher(new GwebSearch());
searchControl.addSearcher(new GvideoSearch());
searchControl.addSearcher(new GblogSearch());
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
// "画"控件到HTML表单上
searchControl.draw(document.getElementById("searchcontrol"));
searchControl.execute("Christmas Eve");
}
显然，你完全可以插入你自己的初始化查询提交到你的代码中，以自定义当你的页面被加载时显示的内容。
JavaScript 分析
在我继续之前，让我们快速回顾一下到目前我们做过的基本工作。第一，一个新的GSearchControl已被创建，如清单3所阐明的那样。这个结构可以让你完成所有的搜索：
清单 3. 创建一个新的GSearchControl
function OnLoad() {
// 创建Google搜索控件
var searchControl = new GSearchControl();
...
}
接着代码使用一个GlocalSearch设置了一个新的本地搜索;这是一个Google执行的控件，它允许你基于你的位置进行搜索。搜索位置的指定如清单4
清单 4. 设置一个新的搜索位置。
function OnLoad() {
// 创建一个Google控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
...
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
...
}
所有这些都是自明的, 一旦你学会对象和方法的调用。清单 4建立一个新的本地搜索器与设置这个搜索器就成为了重点。
清单5里的几行代码精确地告诉搜索控件哪些类型的搜索器将被执行。
清单 5. 指定允许的搜索类型
function OnLoad() {
// 创建一个Google控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
searchControl.addSearcher(localSearch);
searchControl.addSearcher(new GwebSearch());
searchControl.addSearcher(new GvideoSearch());
searchControl.addSearcher(new GblogSearch());
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
...
}
你可以指定许多种搜索类型，这里有一个简单描述：
* GwebSearch: 一个用于搜索Web的对象，这是最常用的参数。
* GvideoSearch: 这个对象使用你的查询条件来搜索视频相关的内容。
* GblogSearch: 这个对象专用于搜索那个结构和标签与其他Web内容类型有细小区别的博客。
你已经学会了如何预加载一个指定的搜索，现在剩下要做的事，就是draw() 方法的调用，(清单 6中的黑体部分) 将你的HTML中的一个DOM元素传给这个调用(关于DOM的引用，可以在资源中查找这个系列的前面的篇章)。 于是，这个控件魔术般地显示在你的表单中，等待你的使用。
清单 6. 绘制搜索控件
function OnLoad() {
// 实例化Google搜索控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
searchControl.addSearcher(localSearch);
searchControl.addSearcher(new GwebSearch());
searchControl.addSearcher(new GvideoSearch());
searchControl.addSearcher(new GblogSearch());
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
// "画"控件到HTML表单上
searchControl.draw(document.getElementById("searchcontrol"));
searchControl.execute("Christmas Eve");
}
可是，Ajax在哪里？
在这个简单的搜索框示例中，的确不容易看出异步的发生。当然，在自己Web应用中的任何位置生成一个Google搜索框，相当酷，可是，这是一个Ajax应用的系列文章，而不是Google搜索应用的系列文章，所以，Ajax在哪里？
键入一个搜索条目并点击Search 按钮,你将注意到一个非常Ajax的响应：搜索结果的提交并没有刷新页面。这可是所有Ajax应用的特点之一 -- 可显示内容的更新不需要刷新页面。很明显,某些事情并没有按普通的request/response模型方式发生。 可是XMLHttpRequest在哪里? 在你所学过的那么多篇文章中提到的request对象在哪里？除了那个getElementById() 方法，DOM与页面控件在哪里？其实，它们都被包装在了你HTML中的两行代码中。
Google搞定了JavaScript
在清单7中，我标出了第一行。我还没有详细介绍呢。
清单 7. 所有重要的JavaScript文件
<script
src="http://www.google.com/uds/api?file=uds.js
&v=1.0&key=
[你的Google开发者ID]"
type="text/javascript"> </script>
这里的语法并没有什么特别有趣的地方，但需要指出的是Google服务器上的那个叫做uds.js的文件，它包含了所有对搜索框进行操作所必须的JavaScript。这是在利用别人的代码时得到的最真实的感受：你甚至正在你的应用中使用第三方服务器上的代码。这是具有相当重要意义的。因为当Google公司进行维护和升级这个JavaScript文件时，你可以自动从中获益。Google不会不让你知道就改变其API，所以无论JavaScript文件是否发生变化，你的代码都将正常工作。
GSearchControl对象
另外的一些代码被隐藏在了 GSearchControl对象, 它在 onLoad() JavaScript 函数中被建立。所有你需要做的事就是如清单8中所做的那样调用代码创建这个对象
清单 8. 创建一个GSearchControl对象
// 创建一个Google搜索对象
var searchControl = new GSearchControl();
HTML所需要做的是如此乏味：只需要一个带有能让你的JavaScript可以引用到的ID的 div标记，就象清单9那样。
清单 9. 关于你要创建的搜索控件，你将要写的HTML
<div id="searchcontrol" />
Google的JavaScript倒底写些什么？
Google的JavaScript可不是那么容易就能理解的。首先，uds.js脚本文件对区域设置进行计算，处理“Google式”的任务，校验你的Google开发者ID，最后下载下列两个脚本 http://www.google.com/uds/js/locale/en/uistrings.js与 http://www.google.com/uds/js/uds_compiled.js。如果你很感兴趣，你可以提取并辛苦地阅读它们，但是小心：理解高级代码总是一件艰巨的工作，特别是它们还有一个非常糟糕的格式！对于你来说，相对于代码行级的巨大麻烦，你的目标更应该是仅仅了解如何使用这些文件罢。
但是，又一次地，Google的代码在幕后做了所有的事。它创建了一个新的文本框，一个传统风格的图形，一个可以调用JavaScript函数的按钮也被写在了Google的JavaScript中。所以，你免费获得了所有的行为;你应该基本明白这些是如何发生的，这样你就能便利的仅只是使用代码，继续你的应用程序。
Ajax并不仅仅是你写的那几行代码
因此， Ajax并不仅仅是你正在使用的XmlHttpRequest; Ajax其实是一种处理Web应用的手段，当然，它基于异步。即使你没有写任何的“Ajax式”的代码，但你仍然建立了一个Ajax应用。感谢Google：它做了这么多的工作，让你受益!
进一步了解Google的Ajax搜索API
现在，是你开始接受这些步骤并让它们配合到你自己的应用的时候了。在最简单的情况下，你只需要拖一个div到你自己的Web页中，加入清单清单1的脚本，之后，一切搞定！
但乐趣并非至此之止。你不要被这些模式选项或控件所限制。无论是Web搜索结果，Blog搜索结果，还是视频搜索结果，你完全可以以适当的方式整合它到你的 Web应用中。你或许还想提供多个搜索控件，每一个产生不同的搜索类型结果。你或许想把Google搜索控件包含在一个span元素里，正确的置于你的应用内容中间，而不是放置于一个边上的div。无论怎样，你的确得记住这一点：应该让Google搜索适合你的需要，而不是修改你的应用去适应Google。
总结
现在对你来说，添加Google搜索框或使用其他的Google API到你的Ajax应用时，应该不会觉得有多难。更进一步，不仅仅是Google搜索框，关于公共API的一般使用，噢！你一定有了相当棒的主意！例如，Amazon.com就提供了一个公共API，它允许你象运行Google那样，完成对Amazon的商店内同类书籍与其他商品的搜索。你可以开始寻找那些你中意的公共API，让它们帮助你超越自己的编程技巧。事实上，你可以非常容易的创建一个站点，将Google，Amazon.com, Flickr以及等等公共API整合到其中。
如何使用Google来转换处理是非常重要的 -- 因为Google提供了搜索算法与海量数据存贮 --了解这一点甚至比学习如何使用任意公共API更重要。你可能已经开始考虑让你的应用超越现有水平的总和;可以说，Google是通向各类数据的大门。这些数据可能存贮在Google，Amazon.com，del.icio.us及任何地方。添加这些数据到你的商业或工程中，你就获得了远超过你自己所能做到的能力与解决方案。
本系列英文链接：http://www-128.ibm.com/developerworks/views/web/libraryview.jsp?search_by=Mastering+Ajax
本系列中文链接：
http://www.ibm.com/developerworks/cn/web/wa-ajaxintro/
利用共公API使你的异步应用获益
developerWorks
等级: 中级
Brett McLaughlin (mailto:brett@newInstance.com?subject=Using the Google Ajax Search API&cc=htc@us.ibm.com), 作者和编辑, O'Reilly Media Inc.
2007年1月23日
创建异步请求并不仅仅只能在你自己的服务器端程序，你完全可以与公共API进行通信，例如Google 或者 Amazon的公共API。 比起使用你自己的脚本和服务器端程序来说，它们可以为你的Web应用提供更多的功能。 在这篇文章中， Brett McLaughlin将教你如何从公共API(如Google)创建请求接收响应。
迄今为止，我们的重点一直放在你的客户端Web页如何创建请求到你的服务器端脚与程序上。这大概可以让80%－90%的 Ajax 应用 -- 使用XMLHttpRequest object对象进行异步通讯的Web应用 -- 工作。但是，一个很明显且严重的局限性放在了我们的面前：你自己的想象力与编程能力毕竟是有限的，即使是在你的公司，你们的想象力或编程技巧也是有限的。
的确，在某些时候你会发现你真的想完成某些事情，但你不具备必须的技术知识来达成目标。可能是你不知道种语言的用法，也可能是如何设计出正确的算法。还有可能，你不能获得必要的信息(无论是人力资料还是数据资源)来满足你的需求。在这样的情况下，或许你就会想：“呀，要是我可以使用那些人的代码该有多好！” 如果你这样想，现在就让我来告诉你怎么做吧。
开放源码的脚本和程序
在我开始这篇文章之前 -- 在你的Web应用中使用 -- 必须要先简单介绍一下开放源码脚本与程序。 开放源码 是一组常常用来描述那些在一定的范围内可以自由地在你的Web应用中使用和重用的代码。相关 资源链接现在大概有10,000行，你可以使用别人已经完成的开放源码，只需要简单的把它们添入你的环境中，没有任何的约束或限制
如果你决定要使用开放源码，有时你必须要在你的应用中加入额外的文档，或者你决定把你的的改进贡献给开源社区。无论你如何使用这些程序，最终的结果都是：你可以使用这些代码而不必再写一遍，或者可能是那些没有足够帮助和没有足够资源你就无法写的代码。象Apache这样的工程，开发者希望能让你的工作更易于获得优势－－不必但心，他们期望你使用他们的成果！
文章及在线教程
通过internet可访问到在IBM developerWorks上发表的资源，无论是文章，还是教程，或者白皮书，均不提及它们的价值，这是一件多么愚蠢的事情。 确实有成百上千篇在线教程，你也许可以找到上百篇的关于Ajax的文章－－我就这个主题也已经写了十篇以上！绝大部分文章中有可用的代码，示例，下载，并且所有这些你都可以使用。
如果你没有能力编写你想使用的服务器端程序或代码，也可能你不能找到你需要的开放源代码程序或脚本，你可以跳到Google并键入你想寻找的简单描述。你通常都会找到应该可以帮你做到你所需要的一篇文章，技巧，或者别的在线片段。你也可以跳到developerWorks，输入同样的简单描述，这时你却能找到正确的完整代码，带有完整说明它是怎么工作的注释的完整脚本。
使用公共的API
很多时候，你会发现，你所面临的问题并不仅仅只是技术。你完全可以搞定所有的脚本和代码，可是你却没有你所需要的数据或资源。在这样的情况下，或许教程和开放源码可以帮到你，但还不够。考虑这样的一种情况,你想在你的Web页中放一个搜索引擎。假定你需要一些你要搜索的数据－－但是如果你想搜索的数据比公司或组织可提供的数据更多时怎么办？
在这种情况下，限制你的不是你的技术能力，而是数据，公共API或许可以解决你的问题。公共API允许你使用其他人的服务器的端口，使用他们的数据。通常，API自己定义你如何与你的程序互动，比如，一个Google搜索引擎的公共API可以让你提出搜索请求，但Google的代码会去搜索Google的数据，之后将结果返回给你的程序。你不仅可以受益于其他人的技术技能，而且受益于远比你或你的公司所能提供的数据贮备。
开始学习使用Google Ajax搜索API
毫无疑问，Google依然是上网应用的重要技术。80的老人和4岁的小孩子都知道Google。即使他们并不明白上网是怎么回事。它是一个非常流行和有用的搜索引擎，并且Google一直致力于提供相当多的免费服务，所以，可以在你自己的程序中使用它的公共API是毫不奇怪的。在这一章，你将学会使用Google API，为帮助你正确的理解如何创建到Google的异步应用通信作准备。
获得Google开发者ID
这篇文章将关注于Google的Ajax搜索API。访问Google Ajax搜索API主页，你可以找到更多关于这方面API的细节，图1是它的一个展示。 (参见 资源 链接 )
图 1. Google的Ajax搜索 API帮助页
Google的Ajax搜索API帮助页
你的第一步是单击Sign up for a Google AJAX Search API key链接。它将跳到一个能让你注册使用Google API的页面。你必须接受这些使用条款--说实在的，我真的觉得一点也不幽默 -- 并提供你自己的应用Web站点的URL (参见图 2).
图2. 注册Google的Ajax搜索API
Signing up for Google's Ajax Search APIn
我应该用什么URL?
Google请求你填写的URL其实就是你的站点的域名。如果你有自己的顶级域名(我就有)，那你就只需要提交http://www.newinstance.com (这是我的服务器的域名，显然，你应该换成你自己的)。如果你的站点是一个大域下的子域或者子目录，你或许需要提供象http: //www.earthlink.net/~bmclaugh 或者 http://brett.earthlink.net的URL。尽管还有其它的特殊情况，但也不要提供过度详细的URL给Google，只需要给它访问你完整Web站点的根URL就可以了。这样你可以在站点下的任何位置使用API。
一旦你读完了条例并选上了复选框，键入了你的URL，点击Generate API Key按钮并等待一到两秒。这时你必须使用你的Google账户联到Google上，或者建立一个新账户。这是很标准的过程，你可以很轻松的搞定。一旦你完成，你会得到一个正确的回复页，那上面列出了一个很长的ID，重复你的URL，甚至还提供给你一个示例代码。那个ID看上去会象这样：
ABQIAAAAjtuhyCXrSHOFSz7zK0f8phSA9fWLQO3TbB2M9BRePlYkXeAu8lHeUgfgRs0eIWUaXg
Google的 API 文档
在你使用分配给你的ID之前，你应该抽点时间去查看一下Google的API文档(在提供给你ID的那个页面的底部有一个链接，我们这篇文章的资源部分也有这个链接). 尽管通过这篇文章你也可以获得好的开始，但是你会发现Google API文档是一个好帮助，它很可能会为你独特的应用提供一些如何在你自己的站点上使用Google的有趣的主意。
最简单的Google搜索Web应用
为了让你了解究竟可以怎么做，让我们一起通过Google提供的Web示例，并做一点点修改，看看它究竟是怎么工作的。
创建一个搜索框
清单1列出了一个相当简单的Web页；把它们键入你喜欢的编辑器中，保存，并上载到你在前面一节中提供给Google的域或者URL。
清单1. 一个简单的Google搜索应用
<html>
<head>
<title>My Google AJAX Search API Application</title>
<link href="http://www.google.com/uds/css/gsearch.css"
type="text/css" rel="stylesheet" />
<script
src="http://www.google.com/uds/api?file=uds.js&v=1.0&key=在这里键入你的ID"
type="text/javascript"> </script>
<script language="Javascript" type="text/javascript">
function OnLoad() {
// 创建一个Google搜索控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
searchControl.addSearcher(localSearch);
searchControl.addSearcher(new GwebSearch());
searchControl.addSearcher(new GvideoSearch());
searchControl.addSearcher(new GblogSearch());
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
// "画"控件到HTML表单上
searchControl.draw(document.getElementById("searchcontrol"));
}
</script>
</head>
<body onload="OnLoad()">
<div id="searchcontrol" />
</body>
</html>
确认使用了你从Google上获得的开发ID替换了黑体字部分。当你下载了这个页面，你应该可以看到如图3那样的页面。
图3. 最简单的从Google进行搜索的页面
The simplest search form for Google
看上去并没有什么，但所有Google的神奇都藏匿在了小小的控件后面。
运行一个搜索
键入一个搜索条件并点击Search以提交到Google。你将很快看到如图4那样的结果弹出。
图4. Google的搜索结果
Google's search results
添加一个预搜索查询
很明显，一旦你执行了一个搜索查询，页面看上去整个都漂亮了许多；视频，博客等，搜索结果有一个比较好看的显示。因此，你或许需要添加一个 预搜索 -- 一个你自定义的搜索查询，当用户下载你的页面时，这个自定义结果将首先显示在用户的浏览器中。要做到这点，只需要在你的JavaScript中添加清单2中的加粗的那一行就够了。
清单 2. 添加一个预搜索查询
function OnLoad() {
// 创建一个Google搜索控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
searchControl.addSearcher(localSearch);
searchControl.addSearcher(new GwebSearch());
searchControl.addSearcher(new GvideoSearch());
searchControl.addSearcher(new GblogSearch());
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
// "画"控件到HTML表单上
searchControl.draw(document.getElementById("searchcontrol"));
searchControl.execute("Christmas Eve");
}
显然，你完全可以插入你自己的初始化查询提交到你的代码中，以自定义当你的页面被加载时显示的内容。
JavaScript 分析
在我继续之前，让我们快速回顾一下到目前我们做过的基本工作。第一，一个新的GSearchControl已被创建，如清单3所阐明的那样。这个结构可以让你完成所有的搜索：
清单 3. 创建一个新的GSearchControl
function OnLoad() {
// 创建Google搜索控件
var searchControl = new GSearchControl();
...
}
接着代码使用一个GlocalSearch设置了一个新的本地搜索;这是一个Google执行的控件，它允许你基于你的位置进行搜索。搜索位置的指定如清单4
清单 4. 设置一个新的搜索位置。
function OnLoad() {
// 创建一个Google控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
...
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
...
}
所有这些都是自明的, 一旦你学会对象和方法的调用。清单 4建立一个新的本地搜索器与设置这个搜索器就成为了重点。
清单5里的几行代码精确地告诉搜索控件哪些类型的搜索器将被执行。
清单 5. 指定允许的搜索类型
function OnLoad() {
// 创建一个Google控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
searchControl.addSearcher(localSearch);
searchControl.addSearcher(new GwebSearch());
searchControl.addSearcher(new GvideoSearch());
searchControl.addSearcher(new GblogSearch());
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
...
}
你可以指定许多种搜索类型，这里有一个简单描述：
* GwebSearch: 一个用于搜索Web的对象，这是最常用的参数。
* GvideoSearch: 这个对象使用你的查询条件来搜索视频相关的内容。
* GblogSearch: 这个对象专用于搜索那个结构和标签与其他Web内容类型有细小区别的博客。
你已经学会了如何预加载一个指定的搜索，现在剩下要做的事，就是draw() 方法的调用，(清单 6中的黑体部分) 将你的HTML中的一个DOM元素传给这个调用(关于DOM的引用，可以在资源中查找这个系列的前面的篇章)。 于是，这个控件魔术般地显示在你的表单中，等待你的使用。
清单 6. 绘制搜索控件
function OnLoad() {
// 实例化Google搜索控件
var searchControl = new GSearchControl();
// 这里允许你自定义在搜索结果中显示的内容。
var localSearch = new GlocalSearch();
searchControl.addSearcher(localSearch);
searchControl.addSearcher(new GwebSearch());
searchControl.addSearcher(new GvideoSearch());
searchControl.addSearcher(new GblogSearch());
// 告诉Google你的位置以便Google知道应该使用哪里的搜索服务器。
localSearch.setCenterPoint("Dallas, TX");
// "画"控件到HTML表单上
searchControl.draw(document.getElementById("searchcontrol"));
searchControl.execute("Christmas Eve");
}
可是，Ajax在哪里？
在这个简单的搜索框示例中，的确不容易看出异步的发生。当然，在自己Web应用中的任何位置生成一个Google搜索框，相当酷，可是，这是一个Ajax应用的系列文章，而不是Google搜索应用的系列文章，所以，Ajax在哪里？
键入一个搜索条目并点击Search 按钮,你将注意到一个非常Ajax的响应：搜索结果的提交并没有刷新页面。这可是所有Ajax应用的特点之一 -- 可显示内容的更新不需要刷新页面。很明显,某些事情并没有按普通的request/response模型方式发生。 可是XMLHttpRequest在哪里? 在你所学过的那么多篇文章中提到的request对象在哪里？除了那个getElementById() 方法，DOM与页面控件在哪里？其实，它们都被包装在了你HTML中的两行代码中。
Google搞定了JavaScript
在清单7中，我标出了第一行。我还没有详细介绍呢。
清单 7. 所有重要的JavaScript文件
<script
src="http://www.google.com/uds/api?file=uds.js
&v=1.0&key=
[你的Google开发者ID]"
type="text/javascript"> </script>
这里的语法并没有什么特别有趣的地方，但需要指出的是Google服务器上的那个叫做uds.js的文件，它包含了所有对搜索框进行操作所必须的JavaScript。这是在利用别人的代码时得到的最真实的感受：你甚至正在你的应用中使用第三方服务器上的代码。这是具有相当重要意义的。因为当Google公司进行维护和升级这个JavaScript文件时，你可以自动从中获益。Google不会不让你知道就改变其API，所以无论JavaScript文件是否发生变化，你的代码都将正常工作。
GSearchControl对象
另外的一些代码被隐藏在了 GSearchControl对象, 它在 onLoad() JavaScript 函数中被建立。所有你需要做的事就是如清单8中所做的那样调用代码创建这个对象
清单 8. 创建一个GSearchControl对象
// 创建一个Google搜索对象
var searchControl = new GSearchControl();
HTML所需要做的是如此乏味：只需要一个带有能让你的JavaScript可以引用到的ID的 div标记，就象清单9那样。
清单 9. 关于你要创建的搜索控件，你将要写的HTML
<div id="searchcontrol" />
Google的JavaScript倒底写些什么？
Google的JavaScript可不是那么容易就能理解的。首先，uds.js脚本文件对区域设置进行计算，处理“Google式”的任务，校验你的Google开发者ID，最后下载下列两个脚本 http://www.google.com/uds/js/locale/en/uistrings.js与 http://www.google.com/uds/js/uds_compiled.js。如果你很感兴趣，你可以提取并辛苦地阅读它们，但是小心：理解高级代码总是一件艰巨的工作，特别是它们还有一个非常糟糕的格式！对于你来说，相对于代码行级的巨大麻烦，你的目标更应该是仅仅了解如何使用这些文件罢。
但是，又一次地，Google的代码在幕后做了所有的事。它创建了一个新的文本框，一个传统风格的图形，一个可以调用JavaScript函数的按钮也被写在了Google的JavaScript中。所以，你免费获得了所有的行为;你应该基本明白这些是如何发生的，这样你就能便利的仅只是使用代码，继续你的应用程序。
Ajax并不仅仅是你写的那几行代码
因此， Ajax并不仅仅是你正在使用的XmlHttpRequest; Ajax其实是一种处理Web应用的手段，当然，它基于异步。即使你没有写任何的“Ajax式”的代码，但你仍然建立了一个Ajax应用。感谢Google：它做了这么多的工作，让你受益!
进一步了解Google的Ajax搜索API
现在，是你开始接受这些步骤并让它们配合到你自己的应用的时候了。在最简单的情况下，你只需要拖一个div到你自己的Web页中，加入清单清单1的脚本，之后，一切搞定！
但乐趣并非至此之止。你不要被这些模式选项或控件所限制。无论是Web搜索结果，Blog搜索结果，还是视频搜索结果，你完全可以以适当的方式整合它到你的 Web应用中。你或许还想提供多个搜索控件，每一个产生不同的搜索类型结果。你或许想把Google搜索控件包含在一个span元素里，正确的置于你的应用内容中间，而不是放置于一个边上的div。无论怎样，你的确得记住这一点：应该让Google搜索适合你的需要，而不是修改你的应用去适应Google。
总结
现在对你来说，添加Google搜索框或使用其他的Google API到你的Ajax应用时，应该不会觉得有多难。更进一步，不仅仅是Google搜索框，关于公共API的一般使用，噢！你一定有了相当棒的主意！例如，Amazon.com就提供了一个公共API，它允许你象运行Google那样，完成对Amazon的商店内同类书籍与其他商品的搜索。你可以开始寻找那些你中意的公共API，让它们帮助你超越自己的编程技巧。事实上，你可以非常容易的创建一个站点，将Google，Amazon.com, Flickr以及等等公共API整合到其中。
如何使用Google来转换处理是非常重要的 -- 因为Google提供了搜索算法与海量数据存贮 --了解这一点甚至比学习如何使用任意公共API更重要。你可能已经开始考虑让你的应用超越现有水平的总和;可以说，Google是通向各类数据的大门。这些数据可能存贮在Google，Amazon.com，del.icio.us及任何地方。添加这些数据到你的商业或工程中，你就获得了远超过你自己所能做到的能力与解决方案。
