/**
* Retrieve a specified nickname and output its ownership information.
*
* @param Zend_Gdata_Gapps $gapps The service object to use for communicating with the Google
* Apps server.
* @param boolean $html True if output should be formatted for display in a web browser.
* @param string $nickname The name of the nickname to be retrieved.
* @return void
*/
function retrieveNickname($gapps, $html, $nickname)
{
if ($html) {
echo "<h2>Nickname Information</h2>\n";
}
$nickname = $gapps->retrieveNickname($nickname);
if ($html) {
echo '<p>';
}
if ($nickname !== null) {
echo ' Nickname: ' . $nickname->nickname->name;
if ($html) {
echo '<br />';
}
echo "\n";
echo ' Owner: ' . $nickname->login->username;
} else {
echo 'Error: Specified nickname not found.';
}
if ($html) {
echo '</p>';
}
echo "\n";
}
