A szolgáltatás használata ingyenes, mindössze regisztrálnunk kell magunkat az alábbi oldalon.
http://www.google.com/apis/
Az oldalról példaprogramokat és leírásokat is letölthetünk a szolgáltatás használatához.
A regisztráció során egy e-mail címet kell megadnunk és egy jelszót. A megadott e-mail címre kapunk egy mail-t, amelyben egy link segítségével aktiválnunk kell regisztrációnkat. Ha ezt megtettük, ismét egy újabb mail-t kapunk, amely tartalmazza a szolgáltatás használatához szükséges license key-t.
Amikor keresni szeretnénk a google-ban, minden egyes alkalommal meg kell adnunk ennek a license key-nek a tartalmát.
Nyissunk egy új alkalmazást, majd válasszuk a Project – Add Web Reference menüpontot. A megjelenő ablakban adjuk meg az alábbi címet, majd kattintsunk az Add Reference feliratú gombra.
http://api.google.com/GoogleSearch.wsdl
A Solution Explorer-ben a Web References ágban láthatóvá is válik az importált webservice. A könnyebb használhatóság érdekében a com.google.api-t nevezzük át Google-re.
A kereső szolgáltatás eléréséhez és használatához két objektumot kell deklarálnunk.
private Google.GoogleSearchService ss = new Google.GoogleSearchService();
private Google.GoogleSearchResult sr;
A GoogleSearchService segítségével használhatjuk a keresőt. A keresés eredménye az sr változóba kerül majd, melynek típusa GoogleSearchResult.
A keresést a doGoogleSearch metódus hajtja végre.
sr = ss.doGoogleSearch(textBox1.Text, textBox2.Text, actualIndex, 10, false, "", false, "", "", "");
doGoogleSearch
GoogleSearchResult doGoogleSearch(
string key,
string q,
int start,
int maxResults,
bool filter,
string restrict,
bool safeSearch,
string lr,
string ie,
string oe
)
Egy megadott szöveg keresését teszi lehetővé a Google adatbázisában.
Paraméterek
string key
A License Key, amelyet a regisztráció során kapunk.
string q
A keresendő szöveg.
int start
Az első megjelenítendő találat indexe.
int maxResults
A megjelenítendő találatok maximális száma. Értéke max. 10 lehet.
bool filter
Automatikus szűrő ki- és bekapcsolását teszi lehetővé. A Google webservice készítőinek javaslata alapján, ezt a paramétert false-ra kell állítanunk.
string restrict
Országok szerinti szűrést tesz lehetővé. Pl.: countryHU. Összetett szűrést is beállíthatunk a logikai operátorok segítségével. (not, and, or).
bool safeSearch
A „felnőtt” szűrő ki- és bekapcsolására szolgál.
string lr
Nyelvi szűrő. Pl.: lang_nl, lang_en, lang_hu. Ilyenkor csak az adott nyelven szereplő találatok jöhetnek számításba. Itt is használhatjuk a logikai operátorokat.
string ie
Ebben a paraméterben üres sztringet kell megadnunk. A paraméter a bemenő szövegek kódolásának meghatározására szolgálna, de bármit teszünk, UTF-8-as formátumot használ.
string oe
Ebben a paraméterben üres sztringet kell megadnunk. A paraméter az eredményül kapott szövegek kódolásának meghatározására szolgálna, de bármit teszünk, UTF-8-as formátumot használ.
Visszatérési érték
Egy tömb, amely a lekérdezés eredményeit tartalmazza.
A keresés összes találatának számát az estimatedTotalResultsCount property-ből tudhatjuk meg.
label4.Text = sr.estimatedTotalResultsCount.ToString();
A találati lista, egyszerre maximum 10 elemét a resultElements tömbön keresztül érhetjük el.
s = sr.resultElements[i].title;
Az eredményül kapott szövegrészek html kódokat is tartalmaznak, mint például a <b>, </b> vagy <br>. Ezeket törölnünk kell a szövegből.
Egy találat címét a title property tartalmazza. A summary-ből megtudhatjuk a találathoz tartozó leírást, a snippet tagban pedig egy rövid részletet kapunk. A találathoz tartozó URL címet az URL tag tartalmazza.
GoogleSearchResult osztály
- bool documentFiltering: igaz érték esetén a keresés során volt szűrő megadva.
- string searchComments: a szerver megjegyzését tartalmazza.
- int estimatedTotalResultsCount: az adatbázisban lévő találatok becsült száma.
- bool estimateIsExact: azt adja meg, hogy az estimatedTotalResultsCount értéke pontos-e.
- ResultElementArray resultElements: egy tömb, amely a találatokat tartalmazza. Egy eleme ResultElement típusú.
- string searchQuery: a lekérdezés szövege.
- int startIndex: az első megjelenítendő találat indexe.
- int endIndex: a találatok maximális száma.
- string searchTips: keresési javaslatok.
- DirectoryCategoryArray directoryCategories: tömb, amely a keresés találataihoz tartozó ODP könyvtárakat tartalmazza.
- double searchTime: a kereséshez felhasznált idő, másodpercekben.
ResultElement osztály
- string summary: az ODP könyvtár tartalomjegyzéke.
- string URL: URL címe.
- string snippet: egy rövid részlet a talált oldalból.
- string title: cím.
- string cachedSize: az oldal mérete kB-okban.
- bool relatedInformationPresent: igaz érték esetén a „related:” lekérdezés is támogatva van az adott oldalnál.
- string hostName: host név.
- DirectoryCategory directoryCategory: ODP könyvtár adatai.
- string directoryTitle: az ODP bejegyzés címe. Az itt található cím különbözhet az URL címtől.