- 准备工作
要使用googleAPI 来开发自己的桌面应用程序,先要做下面的准备工作:
1. 首先在下面地址http://www.google.com/apis/download.html下载the Google Web APIs Developer's Kit。
2. 然后在下面地址https://www.google.com/accounts/NewAccount?continue=http://api.google.com/createkey&followup=http://api.google.com/createkey注册一个 license key 以使用google提供的搜索服务。
- 新建一个Google Search应用程序
1. 新建一个Windows From 项目命名为Google Search。
2. 添加Web引用,以便使用google web services。具体做法是将下载的the Google Web APIs Developer's Kit中的GoogleSearch.wsdl文件放入本地的服务器上,然后在VS中右键点击资源管理器中的引用,再选择添加Web引用,然后输入GoogleSearch.wsdl文件在本机服务器上的地址http://localhost/GoogleSearch.wsdl,更改Web引用名为GoogleSearch后,点击添加引用后返回。
3. 进行界面设计,添加3个控件,TextBox(用于输入关键字),Button(用于提交信息),RichTextBox(用于显示搜索结果信息)。如图:
4. 编写事件处理。
1) 添加命名空间。using Google_Search.googlesearch;
2) 双击Button控件,在Button的事件处理中添加下面的代码:
2
3 {
4
5 GoogleSearchService s = new GoogleSearchService();
6
7 GoogleSearchResult r = s.doGoogleSearch("NGYfW7dQFHKshnXPwvctLsaipk03YK2x", textBox1.Text, 0, 10, true, "", true, "", "", "");
8
9 ResultElement[] re = r.resultElements;
10
11 foreach (ResultElement n in re)
12
13 {
14
15 richTextBox1.AppendText(n.title+"\r");
16
17 richTextBox1.AppendText(n.snippet+"\r");
18
19 richTextBox1.AppendText(n.URL);
20
21 richTextBox1.AppendText("\n\r\r");
22
23 }
24
25 }
26
27
28
29 catch(Exception ee)
30
31 {
32
33 MessageBox.Show(ee.Message);
34
35 }
36
37
3) 按ctrl+F5就能测试应用程序了。
l GoogleSearchServices类doGoogleSearch方法
需要进行搜索先建立一个GoogleSearchServices 类的对象,然后调用doGoogleSearch方法取得信息。下面是google提供的对该方法的描述。
public doGoogleSearch(string key, string q, int start, int maxResults, bool filter, string restrict, bool safeSearch, string lr, string ie, string oe)
下面对各个参数进行介绍:
Key:这是由google提供的一个认证用的ID,可以在http://www.google.com/apis/申请。由于目前是测试阶段,每个ID一天只提供1000次的搜索服务请求。
q:这个就是要搜索的关键字。string类型
start:结果开始的索引数,从0开始。 int 类型
maxresults:返回的结果数的最大值,最大为10。int 类型
filter:用于标识是否对搜索的结果进行过滤,所进行的过滤是对于同一主机上的内容只返回1—2个结果。bool类型
restrict:用于限定搜索的国家或地区,如果为空,表示不限制。string 类型。
下表将列出所有能选的代号。
国家 |
代号 |
国家 |
代号 |
国家 |
代号 |
国家 |
代号 |
|
countryAD |
|
countryEE |
|
countryKZ |
|
countryQA |
|
countryAE |
|
countryEG |
Lao People's Democratic Republic |
countryLA |
|
countryRE |
|
countryAF |
|
countryEH |
|
countryLB |
|
countryRO |
|
countryAG |
|
countryER |
|
countryLC |
|
countryRU |
|
countryAI |
|
countryES |
|
countryLI |
|
countryRW |
|
countryAL |
|
countryET |
|
countryLK |
|
countrySA |
|
countryAM |
European Union |
countryEU |
|
countryLR |
|
countrySB |
|
countryAN |
|
countryFI |
|
countryLS |
|
countrySC |
|
countryAO |
|
countryFJ |
|
countryLT |
|
countrySD |
|
countryAQ |
|
countryFK |
|
countryLU |
|
countrySE |
|
countryAR |
|
countryFM |
|
countryLV |
|
countrySG |
|
countryAS |
|
countryFO |
Libyan Arab Jamahiriya |
countryLY |
|
countrySH |
|
countryAT |
|
countryFR |
|
countryMA |
|
countrySI |
|
countryAU |
France, Metropolitan |
countryFX |
|
countryMC |
Svalbard and |
countrySJ |
|
countryAW |
|
countryGA |
|
countryMD |
|
countrySK |
|
countryAZ |
|
countryUK |
|
countryMG |
|
countrySL |
|
countryBA |
|
countryGD |
|
countryMH |
|
countrySM |
|
countryBB |
|
countryGE |
|
countryMK |
|
countrySN |
|
countryBD |
French Quiana |
countryGF |
|
countryML |
|
countrySO |
|
countryBE |
|
countryGH |
|
countryMM |
|
countrySR |
|
countryBF |
|
countryGI |
|
countryMN |
|
countryST |
|
countryBG |
|
countryGL |
|
countryMO |
|
countrySV |
|
countryBH |
|
countryGM |
|
countryMP |
|
countrySY |
|
countryBI |
|
countryGN |
|
countryMQ |
|
countrySZ |
|
countryBJ |
|
countryGP |
|
countryMR |
|
countryTC |
|
countryBM |
|
countryGQ |
|
countryMS |
|
countryTD |
|
countryBN |
|
countryGR |
|
countryMT |
French Southern Territories |
countryTF |
|
countryBO |
South Georgia and the |
countryGS |
|
countryMU |
|
countryTG |
|
countryBR |
|
countryGT |
|
countryMV |
|
countryTH |
|
countryBS |
|
countryGU |
|
countryMW |
|
countryTJ |
|
countryBT |
|
countryGW |
|
countryMX |
Tokelau |
countryTK |
|
countryBV |
|
countryGY |
|
countryMY |
|
countryTM |
|
countryBW |
|
countryHK |
|
countryMZ |
|
countryTN |
|
countryBY |
Heard and Mc |
countryHM |
|
countryNA |
|
countryTO |
|
countryBZ |
|
countryHN |
|
countryNC |
|
countryTP |
|
countryCA |
|
countryHR |
|
countryNE |
|
countryTR |
Cocos (Keeling) |
countryCC |
|
countryHT |
|
countryNF |
|
countryTT |
|
countryCD |
|
countryHU |
|
countryNG |
|
countryTV |
|
countryCF |
|
countryID |
|
countryNI |
|
countryTW |
|
countryCG |
|
countryIE |
|
countryNL |
|
countryTZ |
|
countryCH |
|
countryIL |
|
countryNO |
|
countryUA |
|
countryCI |
|
countryIN |
|
countryNP |
|
countryUG |
|
countryCK |
|
countryIO |
|
countryNR |
|
countryUM |
|
countryCL |
|
countryIQ |
|
countryNU |
|
countryUS |
|
countryCM |
|
countryIR |
|
countryNZ |
|
countryUY |
|
countryCN |
|
countryIS |
|
countryOM |
|
countryUZ |
|
countryCO |
|
countryIT |
|
countryPA |
Holy See ( |
countryVA |
|
countryCR |
|
countryJM |
|
countryPE |
|
countryVC |
|
countryCU |
|
countryJO |
|
countryPF |
|
countryVE |
|
countryCV |
|
countryJP |
|
countryPG |
|
countryVG |
|
countryCX |
|
countryKE |
|
countryPH |
Virgin Islands ( |
countryVI |
|
countryCY |
|
countryKG |
|
countryPK |
|
countryVN |
|
countryCZ |
|
countryKH |
|
countryPL |
|
countryVU |
|
countryDE |
|
countryKI |
|
countryPM |
|
countryWF |
|
countryDJ |
|
countryKM |
Pitcairn |
countryPN |
|
countryWS |
|
countryDK |
|
countryKN |
|
countryPR |
|
countryYE |
|
countryDM |
|
countryKP |
|
countryPS |
|
countryYT |
|
countryDO |
|
countryKR |
|
countryPT |
|
countryYU |
|
countryDZ |
|
countryKW |
|
countryPW |
|
countryZA |
|
countryEC |
|
countryKY |
|
countryPY |
|
countryZM |
|
|
|
|
|
|
|
countryZR |
safeSearch:使用一个bool值表示是否过滤垃圾信息。
lr:对语言的限制,string类型。可选代号如下表:
语言 |
代号 |
|
语言 |
代号 |
Arabic |
lang_ar |
|
Icelandic |
lang_is |
Chinese (S) |
lang_zh-CN |
|
Italian |
lang_it |
Chinese (T) |
lang_zh-TW |
|
Japanese |
lang_ja |
Czech |
lang_cs |
|
Korean |
lang_ko |
Danish |
lang_da |
|
Latvian |
lang_lv |
Dutch |
lang_nl |
|
Lithuanian |
lang_lt |
English |
lang_en |
|
Norwegian |
lang_no |
Estonian |
lang_et |
|
Portuguese |
lang_pt |
Finnish |
lang_fi |
|
Polish |
lang_pl |
French |
lang_fr |
|
Romanian |
lang_ro |
German |
lang_de |
|
Russian |
lang_ru |
Greek |
lang_el |
|
Spanish |
lang_es |
Hebrew |
lang_iw |
|
Swedish |
lang_sv |
Hungarian |
lang_hu |
|
Turkish |
lang_tr |
ie:输入所使用的字符编码。这个参数将被忽略,所有的输入都将采用UTF-8。
oe:输出所使用的字符编码。这个参数将被忽略,所有的输出都将采用UTF-8
。
通过对这个方法的各个参数的设定可以是自己的应用程序在搜索方面更加人性化。具体使用时可以通过各种控件来收集这些信息。
l GoogleSearchResult类
这个类用于存储搜索结果,下面介绍这个类的一些重要属性:
1. estimatedTotalResultsCount 所有与关键字有关的信息的总数。
2. searchTime 提交信息到返回信息所用的时间。
3. searchTips 根据关键字提供一些与关键字相关的关键字,供选择。
4. resultElements 返回一个数组,用于存储返回结果的每一项。
l Result Element类
这个类的是搜索的结果中的每一项,所有的结果处理都依靠这个类。下面是这个类的一些属性的介绍:
1. URL 显示结果网页的url。
2. snippet 返回在目标网页中摘录一些包含关键字片段。
3. title 目标网页的标题。
4. hostname 该参数显示目标网页所在的主机明。
5. summary 如果目标网页在ODP 目录中存在,则返回摘要信息。
6. directoryTitle 显示ODP 目录的标题。
通过这两个类可以取得各种与查询有关的信息,通过以上的介绍,基本可以使用googleAPI提供的全部功能。