/ 
WebService-Google-Reader-0.01_1
River stage zero No dependents
/ WebService::Google::Reader

NAME

WebService::Google::Reader - Perl interface for Google Reader

SYNOPSIS

use WebService::Google::Reader;

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 ) {
    print $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.

feed

The URL to a RSS / ATOM feed.

<state>

One of ( read, kept-unread, fresh, starred, broadcast, reading-list, tracking-body-link-used, tracking-emailed, tracking-item-link-used, tracking-kept-unread ).

label or tag

A label / tag name.

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

public

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:

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>