deadlime » Google http://deadlime.hu unexpected terminator Tue, 26 Feb 2013 08:19:39 +0000 en-US hourly 1 http://wordpress.org/?v=3.5.1 A Google Reader hasznosítása http://deadlime.hu/2007/11/09/a-google-reader-hasznositasa/ http://deadlime.hu/2007/11/09/a-google-reader-hasznositasa/#comments Fri, 09 Nov 2007 18:40:24 +0000 Nagy Krisztián http://deadlime.hu/2007/11/09/a-google-reader-hasznositasa/ A Google Reader egy rettentő addiktív dolog, ha az ember a feedolvasást választja a hírek beszerzésének kényelmes formájaként. De mi van akkor, ha az itt olvasott dolgokat szeretnénk másokkal is megosztani a saját honlapunkon? És ha a feliratkozásainkból szeretnénk egy blogrollt csinálni az oldalunkon? Természetesen a Google is gondolt erre, ezért mindkettőre van lehetőségünk.

Az alábbiakban szeretném bemutatni, hogy hogyan is valósíthatjuk meg ezeket a dolgokat, valamint mit tehetünk, ha nem elégszünk meg az alap lehetőségekkel.

Blogroll készítése

  1. A Reader felületén kattintsunk az egyik feedünkre és a "Feed settings..." alatt adjunk hozzá egy új könyvtárat (New folder...). Legyen a neve mondjuk "blogroll".
  2. Kellő óvatossággal kattintsuk meg a jobb felső sarokban található "Settings" linket és azon belül is a "Subscriptions" fülecskét.
  3. Jelöljük ki azokat az oldalakat, amiket meg szeretnénk jeleníteni a blogrollunkban és a "More options..." lenyitható űrlapelem segítségével adjuk hozzá a "blogroll" taget.
  4. Menjünk át a "Tags" fülre. A "blogroll" neveztű tag sorában kattintsuk meg azt a kis feed ikonocskát, mire megjelenik egy csomó minden egyéb link is abban a sorban.
  5. A minket érdeklő dolog az "add a blogroll to your site" link. A megkattintás után előjön egy popup, ahol be tudjuk állítani a blogroll dobozunk stílusát.
  6. Most már csak az van hátra, hogy a személyre szabott kódunkat, amit alatta egy textarea-ban legenerált nekünk, kimásoljuk és beillesszük a blogunkra egy megfelelő helyre.

De tényleg csak ennyi lenne? Nem tudom, de nekem nem igazán sikerült olyan színsémát találnom, ami igazán passzolt volna a bloghoz, szóval ideje valami alternatív megoldást keresni. A popupban két <script> tag található. Az első egy olyan JavaScript fájl, ami a megjelenítésért felelős, ezért minket nem is érdekel különösebben. Ám a második egy aranyos JSON fájl, ami egy callback függvénynek átadja a nekünk szükséges adatokat. Ennek a linknek is csak az első fele érdekes számunkra a "callback" részig. A callback utáni részt pedig írjuk át nemes egyszerűséggel updateBlogroll-ra. Ezek után valahogy így fog kinézni:

http://www.google.com/reader/public/javascript-sub/user/AZONOSÍTÓ/label/blogroll?callback=updateBlogroll

Így egy olyan JavaScript kódot fog legenerálni nekünk a Google, ami meghívja az updateBlogroll függvényt és átadja neki a Reader-ünkből származó adatokat. Így már csak annyi a dolgunk, hogy ezt az updateBlogroll függvényt megírjuk, az őt tartalamzó JS fájt betöltsük a honlapunk <head> részében, a fent említett, Reader által generált JS-t pedig az után a tag után, ahova a blogrollt be szeretnénk szúrni. Egy példa az updateBlogroll függvényre (a kód prototype.js-t használ):

function updateBlogroll(data)
{
	var parent = $('blogroll-list');
	parent.innerHTML = '';
	var len = data.items.length;
	for (var i = 0; i < len; ++i)
	{
		parent.insert('<li><a href="'+data.items[i].alternate.href+'">'+data.items[i].title+'</a></li>');
	}
}

Ha ezt a függvényt mondjuk egy update.js fájlba mentjük el, akkor a HTML kódunk valahogy így nézhet ki:

...
<script language="JavaScript" type="text/javascript" src="update.js"></script>
</head>
...
<ul id="blogroll-list">Blogroll betöltése...</ul>
<script language="JavaScript" type="text/javascript" src="http://www.google.com/reader/public/javascript-sub/user/AZONOSÍTÓ/label/blogroll?callback=updateBlogroll"></script>
...

Feed elemek megosztása

Hasonló módon érhetjük el azt is, ha szeretnénk az általunk érdekesnek talált linkeket megosztani a blogunk látogatóival. A Reader beállításainál a "Tags" fülön található egy "Your shared items" (ide úgy kerülnek bele az elemek, ha "Expanded view"-ban Shift+S-t nyomunk egy bejegyzésen vagy megnyomjuk a "Share" linket az elem alján. "List view"-ban csak az utóbbira van lehetőségünk, ha már kinyitottunk egy elemet). Ennek a sorában kattintsuk meg az "add a clip to your site" linket. Egy hasonló popup ugrott fel, mint a blogroll esetében is. Ha nem szeretnénk saját formázást használni akkor a megfelelő beállítások elvégzése után a textarea-ban található kód beillesztésével végeztünk is. Ellenkező esetben ismét a második <script> tagben lévő linket kell kimásolnunk. A callback után most írjuk az updateLinks függvénynevet, valahogy így:

http://www.google.com/reader/public/javascript/user/AZONOSÍTÓ/state/com.google/broadcast?n=15&callback=updateLinks

Az n utáni szám átírásával tudjuk meghatározni, hogy hány darab elemet kapjunk vissza. Az updateLinks függvény is hasonlóan fog kinézni, mint az előző updateBlogroll:

function updateLinks(data)
{
	var parent = $('link-list');
	parent.innerHTML = '';
	var len = data.items.length;
	for (var i = 0; i < len; ++i)
	{
		parent.insert('<li><a href="'+data.items[i].alternate.href+'">'+data.items[i].title+'</a></li>');
	}
}

Természetesen nem csak ennyi adatot kapunk meg az elemekről. Nézzünk pár fontosabbat a teljesség igénye nélkül (a továbbiakért érdemes a kapott fájlba belenézni):

  • data.items[i].published
    A bejegyzés publikálásának időpontja Unix timestamp formában.
  • data.items[i].summarySnippet
    A bejegyzés rövid, összefoglaló szövege.
  • data.items[i].origin.title
    Az oldal neve, ahol megjelent ez a bejegyzés.
  • data.items[i].origin.htmlUrl
    Az oldal címe.

Körülbelül ennyi lenne a Google Reader pár hasznos felhasználási módjáról. A jobb oldali sáv "Linkek" és "Blogroll" részében látható a működő példa.

]]> http://deadlime.hu/2007/11/09/a-google-reader-hasznositasa/feed/ 7 Google Web API http://deadlime.hu/2006/05/14/google-web-api/ http://deadlime.hu/2006/05/14/google-web-api/#comments Sun, 14 May 2006 10:43:04 +0000 Polaa http://deadlime.hu/2006/05/14/google-web-api/ Az egyik legegyszerűbb a google által kínált api-k közül a web api. Ebbe a felületbe három szolgáltatás tartozik bele. Ezek a keresés, a cache-elt oldalak elérése, illetve a helyesírás ellenőrző (google.com -ról ismert Did you mean dolog). Ahhoz, hogy igénybe vehessük az api-t, először regisztrálnunk kell magunknak egy google accountot, majd igényelni kell egy licence key-t. Ezzel a kulccsal napi 1000 kérést hajthatunk végre.

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:

]]> http://deadlime.hu/2006/05/14/google-web-api/feed/ 2