/ 
WebService-Google-Reader-0.01_2
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,
);

my $feed = $reader->feed( state => 'reading-list', count => 100);
my @entries = $feed->entries;

# Fetch past entries.
while ( $reader->feed( $feed ) ) {
    my @entries = $feed->entries;
}

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.

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, even when not required.

ua

An optional useragent object.

$retval = $reader->edit

Edit subscriptions or labels. Returns true on success, false on failure. Accepts the following named parameters:

$retval = $reader->subscribe
$retval = $reader->unsubscribe
$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.

count

The number of entries the feed will contain.

order or sort

The sort order of the entries: desc (default) or asc. When ordering by asc, Google only returns items within 30 days, whereas the default order has no limitation.

start_time

Request entries only newer than this time (represented as a unix timestamp).

@list = $reader->list
@list = $reader->feeds
@list = $reader->subscriptions
@list = $reader->subs
@list = $reader->labels
@list = $reader->tags
$feed = $reader->search
$opml = $reader->opml
$error = $reader->error

Returns the error, if one occurred.

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>