unijimpe

Google SOAP Search API permite a los desarrolladores consultar entre los millones de páginas web indexadas por Google directamente desde tu aplicación usando Web Services. Para ello usa los estándar SOAP y WDSL.

El servicio de Google SOAP Search API es gratuito pero debes registrarte para obtener un key con el cual podras hacer tus consultas hasta un máximo de 1000 consultas por dia.

En nuestro caso usaremos PHP como plataforma de desarrollo e implementaremos un buscador de MP3 basados en reglas de búsqueda. Para poder conectarnos mediante Web Services utilizaremos la librería NuSOAP lo cual nos brindará todas los métodos necesarios para consultar los datos.

Google brinda tres métodos para consultar: Búsquedas, Búsquedas en el cache de Google y Búsqueda Ortográficas. en nuestro caso utilizaremos las búsqueda normal. Para una guia completa de métodos y parámetros puedes visitar Google SOAP Search API Reference.

Para comenzar declaramos nuestras variables e instanciamos al objeto soapclient para conectarnos como cliente al Web Service de Google.

include('nusoap.php');
// Definimos variables
$apikey = "tu_numero_key_google";
$start = $_GET['start'];
$query = $_GET['query'];
// creamos objetos cliente
$sclient = new soapclient('http://api.google.com/search/beta2');
$soptions = 'urn:GoogleSearch';

Luego definimos una función para hacer la consulta en donde creamos el array de parámetros que solicita el servicio. Nótese que $q es la consulta que hacemos en donde hemos agregado una cadena con parámetros de búsqueda avanzada que soporta google el cual filtrará las búsquedas para devolvernos listados de archivos MP3.

function doSearch( $query, $type, $key, $start, &$ret ) {
   global $sclient;
   global $soptions;
   $q = 'intitle:index.of "mp3" +"';
   $q.= $query;
   $q.= '" -htm -html -php -asp "Last Modified"';

   $params = array(
      'key' => $key, 
      'q' => $q, 
      'start' => $start, 
      'maxResults' => 10,
      'filter' => false, 
      'restrict' => '',
      'safeSearch' => false,
      'lr' => '',
      'ie' => '',
      'oe' => ''
   );

   $ret = $sclient->call('doGoogleSearch', $params, $soptions);
   $err = $sclient->getError();

   if ($err) {
      print("
Ocurrio un Error!
");
      print("Error: $err
\n");
      return false;
   }
   return true;
}

Lo siguiente es crear la función para llamara al buscador y verificar que se encuentren resultados y devolver los mensajes de error.

function search( $query, $type, $key, $start, &$ret ) {
    $result = false;
    $max_retries = 5;
    $retry_count = 0;

    while( !$result && $retry_count < $max_retries ) {
		$result = doSearch($query, $type, $key, $start, $ret);
		if(!$result) {
			print( "Attempt $retry_count failed.
\n");
        }    
        $retry_count++;
    }
    if(!$result) {
        print("
La conexión fallo.
\n");
    }
    return $result;
}

Finalmente necesitamos crear un formulario para ingresar nuestra consulta y luego mostrar los resultados de la búsqueda.

<form method="get" action="index.php">
<input name="query" type="text" value="<?php echo $query; ?>">
<input name="buscar" type="submit" value="Buscar">
</form>

if( $query != "" ) {
   $query = stripslashes($query);
   if(doSearch( $query, $type, $apikey, $start, $ret )) {
      $count = $ret['estimatedTotalResultsCount'];
      $secs = round($ret['searchTime'],2);
      $min = $ret['startIndex'];
      $max = $ret['endIndex'];
      if ($max) {
         foreach($ret['resultElements'] as $result) {
            echo $result['title']."
";
            echo $result['snippet']."
";
            echo "";
            echo $result['URL'];
            echo "";
         }
      }
   }
}

Con esto ya tenemos listo, ahora se le pueden agregar opciones como escribir el número de resultados, paginación de resultados y desde luego agregarle estilos y ponerle un diseño. Para ello he trabajado y he puesto una versión completa la cual puedes usar como buscador de mp3.

Finalmente te dejo los archivos fuente para que los revises, en estos solo debes ingresar tu número Key de Google para que funcione.

Posts Relacionados

• Buscador MP3
• Kissa: acortar URLs con PHP
• SWFObject en Google Library
• Reporte del Clima con PHP y Google
• Google AJAX Feed API