=====Greqo Docs : Requesting a Google Auth Token=====
For Google Data services, like the new [[http://code.google.com/apis/gdata/blogger.html Blogger API]], any request or transaction must be accompanied by an authentication token set as a header for the request.  This token must be requested using one of two methods promoted by Google as part of their [[http://code.google.com/apis/gdata/index.html GData API]].  The request_clientlogin_token method will request and store a token for use with any Blogger API requests.  

====Sample Code====
%%(php)

$GreqoBlogger = new GreqoBlogger($debug=1);
$GreqoBlogger->email = 'user@gmail.com';
$GreqoBlogger->password = '*********';

if ( $GreqoBlogger->request_clientlogin_token($service='blogger', $force=1) ) 
{
	$_HTML['stdout'] .= '<p class="success">token for user ' .$GreqoBlogger->email. ' retrieved</p>';
	#$_HTML['stdout'] .= '<p class="success">token: ' .$_SESSION['GDATA']['auth_token']. '</p>';
}
else
{
	$_HTML['stdout'] .= '<p class="failure">unable to retrieve authentication token (devs have been notified)</p>';
}
%%

====Methods====
**string request_clientlogin_token( string Google service[, int force] )**

This method requests an authentication token from the Google servers using the [[http://code.google.com/apis/accounts/AuthForInstalledApps.html ClientLogin interface]]

If the optional ''force'' parameter is set to **0** and the token has already been requested, it will return the current token.  If ''force'' is set to **1**, it will request a new token.  The default is **1**.

It returns the token itself as a string if the request is successful and 0 if it fails or there is an error.  It also assigns the token to **$_SESSION['GDATA']['auth_token']** for reuse within the same session.


====Notes====
How often do you need to renew an authentication token?  The answer seems to be: when in doubt, get a new token.  See [[http://groups.google.com/group/bloggerDev/browse_frm/thread/f41921c75119f442 this post]].

----

[[CategoryGreqo]]