net::google::authsub::response(3pm) [debian man page]

Net::Google::AuthSub::Response(3pm)			User Contributed Perl Documentation		       Net::Google::AuthSub::Response(3pm)

NAME

       Net::Google::AuthSub::Response - a response from a Net::Google::AuthSub request

SYNOPSIS

	   my $response = $auth->login($user, $pass);

	   if ($response->is_success) {
	       print "Yay!
";
	   } else {
	       if ($response->error eq 'CaptchaRequired') {
		   print "Captcha Image ".$response->captchaurl;
	       }
	   }

METHODS

   new "HTTP::Response" "base url"
       Create a new response.

   is_success
       Returns whether the response was a sucess or not.

SUCCESS METHODS

       Methods available if the response was a success.

   auth
       The authorisation token if the response is a success.

   sid
       Not used yet.

   lsid
       Not used yet.

ERROR METHODS

       Methods available if the response was an error.

   error
       The error code. Can be one of

       BadAuthentication
	   The login request used a username or password that is not recognized.

       NotVerified
	   The account email address has not been verified. The user will need to access their Google account directly to resolve the issue before
	   logging in using a non-Google application.

       TermsNotAgreed
	   The user has not agreed to terms. The user will need to access their Google account directly to resolve the issue before logging in
	   using a non-Google application.

       CaptchaRequired
	   A CAPTCHA is required. (A response with this error code will also contain an image URL and a CAPTCHA token.)

       Unknown
	   The error is unknown or unspecified; the request contained invalid input or was malformed.

       AccountDeleted
	   The user account has been deleted.

       AccountDisabled
	   The user account has been disabled.

       ServiceDisabled
	   The user's access to the specified service has been disabled. (The user account may still be valid.)

       ServiceUnavailable
	   The service is not available; try again later.

   url
       The url of a page describing the error.

   captchatoken
       The token required to authenticate a captcha.

   captchaurl
       The full url of the captcha image.

perl v5.10.0							    2009-05-09				       Net::Google::AuthSub::Response(3pm)

WWW::OpenSearch::Response(3pm)				User Contributed Perl Documentation			    WWW::OpenSearch::Response(3pm)

NAME

       WWW::OpenSearch::Response - Encapsulate a response received from an A9 OpenSearch compatible engine

SYNOPSIS

	   use WWW::OpenSearch;

	   my $url = "http://bulkfeeds.net/opensearch.xml";
	   my $engine = WWW::OpenSearch->new($url);

	   # Retrieve page 4 of search results for "iPod"
	   my $response = $engine->search("iPod",{ startPage => 4 });
	   for my $item (@{$response->feed->items}) {
	       print $item->{description};
	   }

	   # Retrieve page 3 of results
	   $response = $response->previous_page;

	   # Retrieve page 5 of results
	   $response = $response->next_page;

DESCRIPTION

       WWW::OpenSearch::Response is a module designed to encapsulate a response received from an A9 OpenSearch compatible engine.  See
       http://opensearch.a9.com/spec/1.1/response/ for details.

CONSTRUCTOR

   new( $response )
       Constructs a new instance of WWW::OpenSearch::Response from the WWWW::OpenSearch:Response returned by the search request.

METHODS

   parse_response( )
       Parses the content of the HTTP response using XML::Feed. If successful, parse_feed( ) is also called.

   parse_feed( )
       Parses the XML::Feed originally parsed from the HTTP response content.  Sets the pager object appropriately.

   previous_page( ) / next_page( )
       Performs another search on the parent object, returning a WWW::OpenSearch::Response instance containing the previous/next page of results.
       If the current response includes a <link rel="previous/next" href="..." /> tag, the page will simply be the parsed content of the URL
       specified by the tag's href attribute. However, if the current response does not include the appropriate link, a new query is constructed
       using the startPage or startIndex query arguments.

   _get_link( $type )
       Gets the href attribute of the first link whose rel attribute is equal to $type.

ACCESSORS

   feed( )
   pager( )
AUTHOR

       o   Tatsuhiko Miyagawa <miyagawa@bulknews.net>

       o   Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE

       Copyright 2005-2010 by Tatsuhiko Miyagawa and Brian Cassidy

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2010-05-25					    WWW::OpenSearch::Response(3pm)