NAME

WebService::Blogger::Blog - represents blog entity of Google Blogger service.

SYNOPSIS

Please see WebService::Blogger.

DESCRIPTION

This class represents a blog in WebService::Blogger package, and is not designed to be instantiated directly.

METHODS

add_entry(%properties)

Adds given entry to the blog:

 my $new_entry = $blog->add_entry(
     title      => 'New entry',
     content    => 'New content',
     categories => [ 'news', 'testing', 'perl examples' ],
 );

search_entries(%criteria)

Returns entries matching specified criteria. The following example contains all possible search conditions:

my @entries = $blog->search_entries( published_min => '2010-08-10T23:25:00+04:00' published_max => '2010-07-17T23:25:00+04:00', updated_min => '2010-09-17T12:25:00+04:00', updated_max => '2010-09-17T14:00:00+04:00', order_by => 'start_time', # can also be: 'last_modified' or 'updated' max_results => 20, offset => 10, # skip first 10 entries );

destroy()

Removes references to the blog from child entries, so they're no longer circular. Blog object as well as entries can then be garbage-collected.

ATTRIBUTES

id

Unique ID of the blog, a string in Blogger-specific format as present in the Atom entry.

numeric_id

Numeric ID of the blog.

title

Title of the blog.

public_url

The human-readable, SEO-friendly URL of the blog.

id_url

URL of the blog based on its numeric ID. Never changes.

post_url

URL for publishing new posts.

entries

List of blog entries, lazily populated.

AUTHOR

Kedar Warriner, <kedar at cpan.org>

BUGS

Please report any bugs or feature requests to bug-webservice-blogger at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-Blogger. 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::Blogger

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-Blogger

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/WebService-Blogger

• CPAN Ratings

  http://cpanratings.perl.org/d/WebService-Blogger

• Search CPAN

  http://search.cpan.org/dist/WebService-Blogger/

ACKNOWLEDGEMENTS

 Many thanks to:
  - Egor Shipovalov who wrote the original version of this module
  - Everyone involved with CPAN.

LICENSE AND COPYRIGHT

Copyright 2010 Kedar Warriner.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.