Intégration du Service Web Google en Asp.Net
Un service web est un programme côté serveur attendant les messages d''applications clientes et transmettant en retour des informations spécifiques. Ces informations peuvent provenir du service web lui même, d''autre composant du même domaine ou d''autres services web. Dans cet article nous allons étudier la conception d''une page aspx cliente du service web du moteur de recherche Google.
Les étapes de cette intégration se résument ainsi :
1- Création du projet :Dans un premier temps nous devons créer un projet ASP.NET Web Application.
2- Ajout de la référence web:Ensuite nous devons ajouter au projet la référence Web du Web service de Google. Il s''agit en l''occurence de : http://api.google.com/GoogleSearch.wsdl. Pour ce faire, cliquez succesivement sur Project, Add Web reference, puis entrez comme addresse http://api.google.com/GoogleSearch.wsdl
Il suffit ensuite de valider l''ajout de la référence en cliquant sur le bouton Add Reference.
Dans l''explorateur de solutions et dans l''explorateur de classes, vous pouvez voir respectivement une nouvelle référence web vers le document WSDL corresponant envoyé au client, et de nouvelles classes disponibles hébergant les méthodes pouvant désormait être appelées au sein de notre projet.
3- Design de notre application:
Pour cet exemple, notre application sera composé de 5 composants essentiels : 3 champs texte qui serviront à entrer respectivement :
* Une clée d''authentification délivré par Google vous permettant d''utiliser leur Web service (pour obtenir une clée enregistrez vous ici http://www.google.com/apis )
* Le sujet de la recherche
* Le nombre de page répondant aux critères de recherche
Il faut également prévoir un bouton Rechercher qui servira à lancer la recherche, et enfin un Datagrid qui affichera les 10 premiers pages correspondant aux critères de recherche. Ce Datagrid sera composé de 2 colonnes : Adresse du site, et Description du site.
4- Appel du service web de Google :La première chose à faire est d''instancier un objet GoogleSearchService que nous appellerons s. Cet objet permettra lancer la recherche. Ensuite, nous devons instancier un autre objet GoogleSearchResult que nous appellerons r. Cet objet stockera le résultat de la recherche lancée avec notre objet s.
La méthode utilisée par s pour lancer la recherche est doGoogleSearch. Cette méthode prend un total de 10 arguments :



Nom
Description
key
Clé d''authentification Google
q
Sujet de la recherche
start
Index du premier élément retourné par la recherche
maxResults
Nombre de résultat maximum à retourner par la méthode (cette valeur doit rester en dessous de 10)
filter
Activation du filtre
restrict
Etablit une restriction
safeSearch
Protéger contrer des sites à contenus adultes
lr
Langue des pages à retourner
ie
Doit être nul
oe
Doit être nul