NAME
WebService::Google::Reader - Perl interface for Google Reader
SYNOPSIS
my
$reader
= WebService::Google::Reader->new(
username
=>
$user
,
password
=>
$pass
,
continue
=> 1,
);
my
$feed
=
$reader
->feed(
state
=>
'reading-list'
,
count
=> 100);
while
(
my
$entry
=
$feed
->entry ) {
$entry
->title,
"\n"
;
}
DESCRIPTION
The WebService::Google::Reader
module provides an interface to the Google Reader service through the unofficial (as-yet unpublished) API.
Note, this is an alpha version and is missing many features. The API of this module is also subject to change.
METHODS
- $reader = WebService::Google::Reader->new
-
Creates a new WebService::Google::Reader object. The constructor accepts the following named parameters:
- username and password
-
Required for accessing any personalized or account-related functionality (reading-list, editing, etc.).
- secure or https
-
Use https scheme for all requests.
- continue
-
When iterating over a feed using the entry iterator, this indicates previous entries should be automatically fetched when the iterator is exhausted and if the feed indicates it has more entries available.
The value of this field indicates the number of seconds to delay (can be fractional) between continued requests. Use a negative number to avoid any delay.
- ua
-
An optional useragent object.
- $status = $reader->login
-
Sends a request to get the SID value for the cookie header. It is not required to explicitly call this method, as the other methods will do so when required.
- $feed = $reader->feed
-
Returns a subclass of XML::Atom::Feed. Accepts the following named parameters:
- feed or state or label or tag
-
One (and only one) of these fields must be present.
- continue
-
A feed-specific setting. See
new
for a full description of this field. - count
-
The number of entries the feed will contain.
- order
-
The sort order of the entries: desc (default) or asc.
- start_time
-
Request entries only newer than this time (represented as a unix timestamp).
- $error = $reader->error
-
Returns the error, if one occurred.
ACCESSORS
TODO
Lots!
SEE ALSO
http://code.google.com/p/pyrfeed/wiki/GoogleReaderAPI
REQUESTS AND BUGS
Please report any bugs or feature requests to http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-Google-Reader. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc WebService::Google::Reader
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
CPAN Ratings
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-Google-Reader
Search CPAN
COPYRIGHT AND LICENSE
Copyright (C) 2007 gray <gray at cpan.org>, all rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
AUTHOR
gray, <gray at cpan.org>