Először is, vadásznunk kell magunknak egy application id-t, amit majd minden kéréshez hozzá kell csatolnunk. Ehhez szükségünk lesz egy Yahoo! ID-re is, mert akkor már ugye növeljük a Yahoo! felhasználók táborát. Ha minden megvan, akkor igazából készen is vagyunk és kezdhetünk kódot írni. A kódoláshoz használtam a cURL kiterjesztést, mivel ez nagyban megkönnyíti a dolgunkat, de használhatnánk file_get_contents() függvényt, ha engedélyezve van a php.ini-ben az allow_url_fopen vagy pedig használhatjuk az fsockopen() függvényt is, ha lehetőségünk van rá.

No, csapjunk a lecsóba, nézzünk egy kis kódot, amivel megkaphatjuk egy keresés eredményét XML formátumban:

header('Content-Type: text/xml');

$app_id = 'ide jön az application id';

$service = array(
	'image' => 'http://api.search.yahoo.com/ImageSearchService/V1/imageSearch',
	'local' => 'http://api.local.yahoo.com/LocalSearchService/V1/localSearch',
	'news' => 'http://api.search.yahoo.com/NewsSearchService/V1/newsSearch',
	'video' => 'http://api.search.yahoo.com/VideoSearchService/V1/videoSearch',
	'web' => 'http://api.search.yahoo.com/WebSearchService/V1/webSearch'
);

$conn = curl_init($service['web'].'?appid='.$app_id.'&query=deadlime');
curl_setopt($conn, CURLOPT_HEADER, false);
curl_setopt($conn, CURLOPT_RETURNTRANSFER, true);
$xml = curl_exec($conn);
curl_close($conn);
 
echo $xml;

Mint az látszik, van egy $service tömb, amiben tároljuk a Yahoo! egyes API-jainak az elérési útját. Tulajdonképpen mindenféle PHP nélkül a böngészőben is játszhatnánk ezzel, hogy beírjuk címnek az egyik szolgáltatást és a következő GET paraméterekkel bővítjük a lekérdezést:

appid

Az application id, amit kaptál.

query

A lekérés szövege, érdemes lefuttatni rajta egy urlencode() vagy rawurlencode() függvényt.

zip

Zipcode, csak a Local Search szolgáltatásnál használható.

start

Ezzel lehet megadni, hogy hányadik elemtől mutassa a találatokat.

Nincs más hátra, mint kinyerni az adatokat a kapott XML fájlból, aminek a formátuma a $service['web'] esetén (ezt használtuk a fentebbi PHP példában) a következő:

<ResultSet xsi:schemaLocation="urn:yahoo:srch http://api.search.yahoo.com/WebSearchService/V1/WebSearchResponse.xsd" totalResultsAvailable="" totalResultsReturned="" firstResultPosition="">
	<Result>
		<Title></Title>
		<Summary></Summary>
		<Url></Url>
		<ClickUrl></ClickUrl>
		<ModificationDate></ModificationDate>
		<MimeType></MimeType>
		<Cache>
			<Url></Url>
			<Size></Size>
		</Cache>
	</Result>
</ResultSet>

Nagyjából ennyi lenne a dolog. Mint az jól látszik, nem annyira testreszabható, mint a Google által kínált felület, viszont próbára tehetjük vele az XML értelmezési tudásunkat... :)

A szolgáltatások elérése SOAP-al történik. Java illetve .NET nyelvekhez példaprogramokat is letölthetünk, illetve az osztálykönyvtárakat is a könnyebb eléréshez. Php-ben a beépített SOAP kiterjesztés áll a rendelkezésünkre. Ahhoz, hogy el is érjük ezt a kiterjesztést, linuxon az --enable-soap kapcsolót kell használni, illetve a php.ini-ben szerepeltetni kell az extension-oknál. Első dolgunk, hogy példányosítunk egy SOAP klienst.

$client = new SoapClient('http://api.google.com/GoogleSearch.wsdl');

A kliensnek kezdésként meg kell adnunk a web szolgáltatást leíró fájl címét. Ebből fogja "tudni", hogy milyen szolgáltatások, milyen függvények hívhatók meg és azokra mit kell visszakapnia.

A példányosítás után már elég könnyű dolgunk van, csak a megfelelő függvényeket kell meghívnunk a kliensen keresztül. A visszatérési érték mindhárom esetben más típusú.
A helyesírás ellenőrző:

try
{
	$params = array(
		'key' 		=> '',		# licence key					
		'phrase' 	=> 'deadlime'	# kifejezés
	);
	$response = $client->__soapCall('doSpellingSuggestion', $params);

	# mivel wsdl módban vagyunk, ezért akár közvetlenül is meghívhatnánk a függvényt
	//$response = $client->doSpellingSuggestion(...);
}
catch(Exception $e)
{
	die($e->getMessage());
}

A $response string típusú, ami vagy üres vagy a felajánlott szót tartalmazza. Magyar szavakra sajnos nem működik. Közvetlen hívás esetén a $params tömb helyett "normál" paraméterezéssel kell megadnunk az adatokat.
A cache-elt oldal:

try
{
	$params = array(
		'key' => '', 				# licence key
		'url' => 'http://www.deadlime.hu'	# az oldal címe, amiről a google által tároltat szeretnénk megkapni
	);
	$response = $client->__soapCall('doGetCachedPage', $params);
	$response = base64_decode($response);
}
catch(Exception $e)
{
	die($e->getMessage());
}

A cache-elt oldalt base64-ben kódolt szövegként kapjuk meg.
A keresés:

try
{
	$params = array(
		'key' 		=> '',  	# licence key
		'q' 		=> 'deadlime',	# keresési kifejezés
		'start' 	=> 0,		# melyik elemtől kezdve adja vissza a találatokat
		'maxResults' 	=> 10,		# mennyi találatot adjon vissza
		'filter' 	=> true,	# eredmény szűrése
		'restrict' 	=> 'countryHU',	# megkötések
		'safeSearch' 	=> false,	# felnőtt tartalmak szűrése
		'lr' 		=> 'lang_hu',	# nyelvi megszorítások
		'ie'		=> '',		# bemeneti karakterkódolás (alapértelmezett: UTF-8)
		'oe'		=> ''		# kimeneti karakterkódolás (alapértelmezett: UTF-8)
	); 
	$response = $client->__soapCall('doGoogleSearch', $params);
}
catch(Exception $e)
{
	die($e->getMessage());
}

A $response ebben az esetben egy objektum, benne minden fontos adattal. A "filter" illetve a "restrict" sor elsőre valószínűleg nem egyértelmü. A "filter" bekapcsolásával a duplikált találatokat lehet kiszürni. A "restrict" értékéül egy kifejezést adhatunk. Ebben a kifejezésben megadhatjuk, hogy mely oszrágokra, illetve mely témakörökre korlátozzuk a keresést.

Kapcsolódó linkek:

• Google Account
• Google Licence Key
• php.net/SOAP