Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
REST::Google::Feeds(3)User Contributed Perl DocumentatioREST::Google::Feeds(3)

NAME
       REST::Google::Feeds - OO	interface to Google Feeds API

SYNOPSIS
	       use REST::Google::Feeds;

	       REST::Google::Feeds->http_referer('http://example.com');

	       my $res = REST::Google::Feeds->new('http://digg.com/rss/index.xml');

	       die "response status failure" if	$res->responseStatus !=	200;

	       my $feed	= $res->responseData->feed;

	       printf "title: %s\n", $feed->title;
	       printf "link: %s\n", $feed->link;
	       printf "description: %s\n", $feed->description;

	       foreach my $e ( $feed->entries )	{
		       printf "\n";
		       printf "title: %s\n", $e->title;
		       printf "link: %s\n", $e->link;
		       printf "date published: %s\n", $e->publishedDate;
	       }

DESCRIPTION
       "REST::Google::Feeds" provides OO interface to Google REST (aka AJAX)
       API for feeds.

METHODS
       __PACKAGE__->http_referer()
	   Get/set HTTP	"Referer" header.

	   Note: Google	says that you should supply a valid HTTP referer
	   header each time you	perform	a request to their AJAX	API, so
	   "new()" raises warning unless referer is specified.

       __PACKAGE__->new()
	   "q" argument	should contain URL to a	valid RSS or Atom feed.
	   Please refer	to 'Google Feeds AJAX API' documentation for complete
	   list	of arguments for Google	Feeds service. E.g.:

		   my $res = REST::Google::Feeds->new(
			   q =>	'http://digg.com/rss/index.xml',
		   );

	   The code above will perform a following HTTP	GET request:

		   http://ajax.googleapis.com/ajax/services/feed/load?q=http%3A%2F%2Fdigg.com%2Frss%2Findex.xml&v=1.0

	   Note: You can left protocol version number unspecified while	making
	   your	searches since "v=1.0" is passed by default.

	   See REST::Google "new" method.

       responseData
	   Method returns "REST::Google::Feeds::Data" object, which has	a
	   single method "feed".

		   my $res = REST::Google::Feeds->new(
			   q =>	'http://digg.com/rss/index.xml',
		   );

		   my $feed = $res->responseData->feed;

       feed
	   Method returns "REST::Google::Feeds::Feed" object, which has
	   accessors for all incapsulated data.

		   my $feed = $res->responseData->feed;
		   print $feed->title;
		   print $feed->link;

	   Attributes of $feed are:

		   title
		   link
		   author
		   description
		   type
		   entries

	   Obtaining feed entries:

		   foreach my $entry ($feed->entries) {
			   print $entry->title;
		   }

	   Attributes of $entry	are:

		   title
		   link
		   author
		   publishedDate
		   contentSnippet
		   content
		   categories

SEE ALSO
       REST::Google - the base class for this module

       <http://code.google.com/apis/ajaxfeeds/documentation/#fonje> - Google
       Feeds AJAX API

LICENSE	AND COPYRIGHT
       Copyright 2008, Eugen Sobchenko <ejs@cpan.org> and Sergey Sinkovskiy
       <glorybox@cpan.org>

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

perl v5.32.0			  2020-08-25		REST::Google::Feeds(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | SEE ALSO | LICENSE AND COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=REST::Google::Feeds&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help