Développer un outil avec la Google API (SOAP)

Par Olivier Duffez , Vendredi 20 septembre 2002

Ces publicités sont réduites voire supprimées pour les membres WebRankInfo.

La Google API est un kit de développement logiciel disponible librement, qui permet de créer de nouvelles applications utilisant directement la base de données des pages indexées par Google, par le biais d'un service web. Cette article a pour objectif de vous aider à développer vous-même un outil basé sur l'API Google.

Mise à jour (déc. 2006) : Google ne permet plus de créer de clé pour son API SOAP (décrite ci-dessous). Seuls ceux qui ont déjà une clé pourront utiliser l'API SOAP.

C'est vraiment très simple, il vous suffit de connaître un peu le PHP et de suivre les 3 étapes suivantes :

Etape 1 : s'inscrire auprès de Google et obtenir une clé

Pour utiliser la Google API, il faut s'enregistrer auprès de Google. Cette procédure est très simple, il suffit de donner un mot de passe et une adresse email dans le formulaire situé sur https://www.google.com/accounts/NewAccount.
Après confirmation, vous recevrez votre clé ("key") qui servira à développer avec l'API Google.

Etape 2 : récupérer les classes d'accès en PHP

Pour développer des outils, vous avez besoin d'une série de classes écrites en PHP, qui permettent d'interroger très facilement Google. Vous pouvez télécharger le fichier google-api.zip qui contient un fichier PHP qu'il faudra inclure dans chaque script qui utilise la Google API.

Etape 3 : développer ses propres outils

Une fois que vous avez obtenu votre clé et récupéré les classes, il est très simple de faire une requête Google. Un exemple vaut mieux qu'un long discours, voici donc un script qui récupère les 10 premiers résultats d'une requête sur Google, effectuée via l'API Google :

// inclusion de la bibliotheque
include("google-api.php");

// la cle (n'oubliez pas de la remplacer par votre cle)
$cle = '01234567890123456789012345678901';

// le nb de pages est bloque a 10
$nb_par_page = 10;

// notre requete (mettez ce que vous voulez !)
$q = "site:www.webrankinfo.com google api";

// on cree un objet pour utiliser la Google API
$google = new GoogleApiSearch;

// par defaut on recupere les premiers resultats, mais on peut faire une
// boucle qui fait varier $start pour recuperer les 1000 premiers resultats
$start = 0;

// lancement de la requete
$result = $google->doGoogleSearch($cle, $q, $start);

// on verifie le resultat de la requete
if ( $result == false )
{
  // la requete n'a pas pu fonctionner
 echo "Désolé... La requête a échoué.
       Réessayez d'ici quelques heures...";
}
else
{
 // la requete a reussi, on regarde maintenant le nb de resultats

 // nombre estime de resultats
 $nb_res = $result['estimatedTotalResultsCount'];
 if ( $nb_res == 0 )
 {
   // aucun resultat
   echo "Aucun résultat.";
 }
 else
 {
   // on affiche les resultats
   foreach ($result['resultElements'] as $resultat)
   {
     // URL, titre et description
     echo $resultat["URL"]."<br>";
     echo "title :<b>".$resultat["title"]."</b><br>";
     echo "snippet :".$resultat["snippet"]."<br><br>";
  }
 }
}

Libre à vous de faire d'autres requêtes, et de boucler pour obtenir plus de 10 résultats par requête (paramètre $start).
Sachez cependant que Google limite l'utilisation de la Google API à 1000 requêtes par jour (chaque requête pouvant renvoyer au maximum 10 résultats).

Tous les outils disponibles sur le site WebRankInfo sont basés sur la Google API, unique moyen officiel d'interroger la base de données de Google de façon automatisée (c'est-à-dire autrement qu'en passant par le site de Google).

Si vous souhaitez publier un extrait de cet article sur votre site, assurez-vous de respecter les conditions générales d'utilisation de WebRankInfo.