Google搜索客户端API for C/C++[VC/C++编程]

Google 网站上供应了goole search client api for Java和for dot.net的版本,大家可以参考.

For C/C++的版本特点以下

内置XML解析器.

内置gbk/utf-8编码/解码器(包含GBK编码表)

采取Pure C编写,采取尺度C接口.

支持http代理.

用户需求在http://api.谷歌.com/createkey申请key

演示程序中的key是一个网友给我的,仅供测试用,演示程序中的代理大概衔接不上,由于没有设置超时,大概处于等候状况(sorry.....)

函数中各个参数的意义和http://www.谷歌.com/apis/reference.html的阐明一样,对此不作过量的介绍.

倡议在此底子上开辟二次利用,如封装成COM,但不得对作者供应的api举行反编译.

如需转载,请注明原作者,谢谢合作.欢送交流.

函数接口

/************************************************************************/
　　　　　　/*谷歌 search client api for c/c++*/
　　　　　　/*By littlestar,2003,TRS Open Lab*/
/************************************************************************/
//go http://www.谷歌.com/apis/reference.html for more information
/*start primitive data types*/
#ifdef _SOAP_TYPES
typedef char * xsd__string;
typedef int xsd__int;
struct xsd__base64Binary
{
　　unsigned char *__ptr;
　　int __size;
};
typedef bool xsd__boolean;
typedef double xsd__double;
/*end primitive data types*/
struct DirectoryCategoryArray
{
　　struct typens__DirectoryCategory * __ptr;
　　int　__size;
　　int　__offset;
};
struct typens__ResultElement
{
　　xsd__string　summary;
　　xsd__string　URL;
　　xsd__string　snippet;
　　xsd__string　title;
　　xsd__string　cachedSize;
　　xsd__boolean　relatedInformationPresent;
　　xsd__string　hostName;
　　struct typens__DirectoryCategory * directoryCategory;
　　xsd__string　directoryTitle;
};
struct typens__doGoogleSearchResponse
{
　　struct typens__GoogleSearchResult * _return_;
};
struct typens__DirectoryCategory
{
　　xsd__string　fullViewableName;
　　xsd__string　specialEncoding;
};
struct typens__GoogleSearchResult
{
　　xsd__boolean　documentFiltering;
　　xsd__string　searchComments;
　　xsd__int　estimatedTotalResultsCount;
　　xsd__boolean　estimateIsExact;
　　struct ResultElementArray * resultElements;
　　xsd__string　searchQuery;
　　xsd__int　startIndex;
　　xsd__int　endIndex;
　　xsd__string　searchTips;
　　struct DirectoryCategoryArray * directoryCategories;
　　xsd__double　searchTime;
};
struct ResultElementArray
{
　　struct typens__ResultElement * __ptr;
　　int　__size;
　　int　__offset;
};
struct typens__doSpellingSuggestionResponse
{
　　xsd__string　_return_;
};
struct typens__doGetCachedPageResponse
{
　　struct xsd__base64Binary * _return_;
};
#endif
//成立Soap衔接
extern "C" int _stdcall CreateSoapSession(void **SoapSessionHandle,char
*strServerAdd,char *key);
//设置代理服务器,支持http代理.
extern "C" int _stdcall SetSoapProxy(void *SoapSessionHandle,char
*strProxyHost,int ProxyPort);
//页面检索
extern "C" int _stdcall doGoogleSearch(void *SoapSessionHandle, xsd__string
q, xsd__int　start, xsd__int　maxResults, xsd__boolean　filter,
xsd__string　restrict_, xsd__boolean　safeSearch, xsd__string　lr,
xsd__string　ie, xsd__string　oe, struct typens__doGoogleSearchResponse *
out);
//获得谷歌服务器上的缓存页面
extern "C" int _stdcall doGetCachedPage(void *SoapSessionHandle,
xsd__string　url, struct typens__doGetCachedPageResponse * out );
//拼写查抄
extern "C" int _stdcall doSpellingSuggestion(void *SoapSessionHandle,
xsd__string　phrase, struct typens__doSpellingSuggestionResponse * out );
//获得SOAP错误消息
extern "C" char* _stdcall GetSoapErrorMessage(void *SoapSessionHandle);
//释放SOAP缓存.
extern "C" int _stdcall FreeSoapCache(void *SoapSessionHandle);
//释放Soap衔接
extern "C" int _stdcall FreeSoapSession(void **SoapSessionHandle);谷歌 供应的wsdl文件<?xml version="1.0"?>
<!-- WSDL description of the Google Web APIs.
　　 The Google Web APIs are in beta release. All interfaces are subject to
　　 change as we refine and extend our APIs. Please see the terms of use
　　 for more information. -->
<!-- Revision 2002-08-16 -->
<definitions name="GoogleSearch"
　　　　　　 targetNamespace="urn:GoogleSearch"
　　　　　　 xmlns:typens="urn:GoogleSearch"
　　　　　　 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
　　　　　　 xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
　　　　　　 xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
　　　　　　 xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
　　　　　　 xmlns="http://schemas.xmlsoap.org/wsdl/">
　<!-- Types for search - result elements, directory categories -->
　<types>
　　<xsd:schema xmlns="http://www.w3.org/2001/XMLSchema"
　　　　　　　　targetNamespace="urn:GoogleSearch">
　　　　　　
　　　<xsd:complexType name="GoogleSearchResult">
　　　　<xsd:all>
　　　　　<xsd:element name="documentFiltering"　　　　　
type="xsd:boolean"/>
　　　　　<xsd:element name="searchComments"　　　　　　　
type="xsd:string"/>
　　　　　<xsd:element name="estimatedTotalResultsCount"　type="xsd:int"/>
　　　　　<xsd:element name="estimateIsExact"　　　　　　
type="xsd:boolean"/>
　　　　　<xsd:element name="resultElements"　　　　　　　
type="typens:ResultElementArray"/>
　　　　　<xsd:element name="searchQuery"　　　　　　　　
type="xsd:string"/>
　　　　　<xsd:element name="startIndex"　　　　　　　　　type="xsd:int"/>
　　　　　<xsd:element name="endIndex"　　　　　　　　　　type="xsd:int"/>
　　　　　<xsd:element name="searchTips"　　　　　　　　　
type="xsd:string"/>
　　　　　<xsd:element name="directoryCategories"　　　　
type="typens:DirectoryCategoryArray"/>
　　　　　<xsd:element name="searchTime"　　　　　　　　　
type="xsd:double"/>
　　　　</xsd:all>
　　　</xsd:complexType>
　　　<xsd:complexType name="ResultElement">
　　　　<xsd:all>
　　　　　<xsd:element name="summary" type="xsd:string"/>
　　　　　<xsd:element name="URL" type="xsd:string"/>
　　　　　<xsd:element name="snippet" type="xsd:string"/>
　　　　　<xsd:element name="title" type="xsd:string"/>
　　　　　<xsd:element name="cachedSize" type="xsd:string"/>
　　　　　<xsd:element name="relatedInformationPresent"
type="xsd:boolean"/>
　　　　　<xsd:element name="hostName" type="xsd:string"/>
　　　　　<xsd:element name="directoryCategory"
type="typens:DirectoryCategory"/>
　　　　　<xsd:element name="directoryTitle" type="xsd:string"/>
　　　　</xsd:all>
　　　</xsd:complexType>
　
　　　<xsd:complexType name="ResultElementArray">
　　　　<xsd:complexContent>
　　　　　<xsd:restriction base="soapenc:Array">
　　　　　　 <xsd:attribute ref="soapenc:arrayType"
wsdl:arrayType="typens:ResultElement[]"/>
　　　　　</xsd:restriction>
　　　　</xsd:complexContent>
　　　</xsd:complexType>
　　　<xsd:complexType name="DirectoryCategoryArray">
　　　　<xsd:complexContent>
　　　　　<xsd:restriction base="soapenc:Array">
　　　　　　 <xsd:attribute ref="soapenc:arrayType"
wsdl:arrayType="typens:DirectoryCategory[]"/>
　　　　　</xsd:restriction>
　　　　</xsd:complexContent>
　　　</xsd:complexType>
　　　<xsd:complexType name="DirectoryCategory">
　　　　<xsd:all>
　　　　　<xsd:element name="fullViewableName" type="xsd:string"/>
　　　　　<xsd:element name="specialEncoding" type="xsd:string"/>
　　　　</xsd:all>
　　　</xsd:complexType>
　　</xsd:schema>
　</types>
　<!-- Messages for Google Web APIs - cached page, search, spelling. -->
　　　　　　
　<message name="doGetCachedPage">
　　<part name="key"　　　　　　type="xsd:string"/>
　　<part name="url"　　　　　　type="xsd:string"/>
　</message>
　<message name="doGetCachedPageResponse">
　　<part name="return"　　　　 type="xsd:base64Binary"/>
　</message>
　<message name="doSpellingSuggestion">
　　<part name="key"　　　　　　type="xsd:string"/>
　　<part name="phrase"　　　　 type="xsd:string"/>
　</message>
　<message name="doSpellingSuggestionResponse">
　　<part name="return"　　　　 type="xsd:string"/>
　</message>
　<!-- note, ie and oe are ignored by server; all traffic is UTF-8. -->
　<message name="doGoogleSearch">
　　<part name="key"　　　　　　type="xsd:string"/>
　　<part name="q"　　　　　　　type="xsd:string"/>
　　<part name="start"　　　　　type="xsd:int"/>
　　<part name="maxResults"　　 type="xsd:int"/>
　　<part name="filter"　　　　 type="xsd:boolean"/>
　　<part name="restrict"　　　 type="xsd:string"/>
　　<part name="safeSearch"　　 type="xsd:boolean"/>
　　<part name="lr"　　　　　　 type="xsd:string"/>
　　<part name="ie"　　　　　　 type="xsd:string"/>
　　<part name="oe"　　　　　　 type="xsd:string"/>
　</message>
　<message name="doGoogleSearchResponse">
　　<part name="return"　　　　 type="typens:GoogleSearchResult"/>　　　　　
　</message>
　<!-- Port for Google Web APIs, "GoogleSearch" -->
　<portType name="GoogleSearchPort">
　　<operation name="doGetCachedPage">
　　　<input message="typens:doGetCachedPage"/>
　　　<output message="typens:doGetCachedPageResponse"/>
　　</operation>
　　<operation name="doSpellingSuggestion">
　　　<input message="typens:doSpellingSuggestion"/>
　　　<output message="typens:doSpellingSuggestionResponse"/>
　　</operation>
　　<operation name="doGoogleSearch">
　　　<input message="typens:doGoogleSearch"/>
　　　<output message="typens:doGoogleSearchResponse"/>
　　</operation>
　</portType>
　<!-- Binding for Google Web APIs - RPC, SOAP over HTTP -->
　<binding name="GoogleSearchBinding" type="typens:GoogleSearchPort">
　　<soap:binding style="rpc"
　　　　　　　　　transport="http://schemas.xmlsoap.org/soap/http"/>
　　<operation name="doGetCachedPage">
　　　<soap:operation soapAction="urn:GoogleSearchAction"/>
　　　<input>
　　　　<soap:body use="encoded"
　　　　　　　　　 namespace="urn:GoogleSearch"
　　　　　　　　　
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
　　　</input>
　　　<output>
　　　　<soap:body use="encoded"
　　　　　　　　　 namespace="urn:GoogleSearch"
　　　　　　　　　
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
　　　</output>
　　</operation>
　　<operation name="doSpellingSuggestion">
　　　<soap:operation soapAction="urn:GoogleSearchAction"/>
　　　<input>
　　　　<soap:body use="encoded"
　　　　　　　　　 namespace="urn:GoogleSearch"
　　　　　　　　　
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
　　　</input>
　　　<output>
　　　　<soap:body use="encoded"
　　　　　　　　　 namespace="urn:GoogleSearch"
　　　　　　　　　
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
　　　</output>
　　</operation>
　　<operation name="doGoogleSearch">
　　　<soap:operation soapAction="urn:GoogleSearchAction"/>
　　　<input>
　　　　<soap:body use="encoded"
　　　　　　　　　 namespace="urn:GoogleSearch"
　　　　　　　　　
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
　　　</input>
　　　<output>
　　　　<soap:body use="encoded"
　　　　　　　　　 namespace="urn:GoogleSearch"
　　　　　　　　　
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
　　　</output>
　　</operation>
　</binding>
　<!-- Endpoint for Google Web APIs -->
　<service name="GoogleSearchService">
　　<port name="GoogleSearchPort" binding="typens:GoogleSearchBinding">
　　　<soap:address location="http://api.谷歌.com/search/beta2"/>
　　</port>
　</service>
</definitions>(全文完)