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:

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.