The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

WWW::Blogger::XML::API - How to Interface with Blogger using HTTP Protocol and GData XML Atom API.

http://code.google.com/apis/blogger/developers_guide_protocol.html

SYNOPSIS

 use WWW::Blogger;

 my $request = WWW::Blogger::XML::API::list_of_blogs_by_userid( $userid );

 my $result = WWW::Blogger::XML::API::ua_request( $request );

OPTIONS

--xml_ua_dmp

user agent transaction dump

--xml_request_dmp

transaction request dump

--xml_result_dmp

transaction result dump

DESCRIPTION

XML::API stands for XML Application Programming Interface

See: http://code.blogger.com http://code.google.com/apis/blogger http://code.google.com/apis/blogger/developers_guide_protocol.html

Demo

    WWW::Blogger::XML::demo()

Setting a new account

    WWW::Blogger::XML::API::set_account( $username, $password );

Retrieving a list of blogs

    $request = WWW::Blogger::XML::API::list_of_blogs_by_userid( $userid );

    $result = WWW::Blogger::XML::API::ua_request( $request );

    See Example: WWW::Blogger::XML::parse_list_of_blogs( $result )

Creating posts

1. Publishing a blog post

    $request = WWW::Blogger::XML::test_post_by_blogid( $blogid ) ## a Test Post

    -OR-

    $request = WWW::Blogger::XML::API::post_entry_by_blogid( $blogid, $entry );

    $result = WWW::Blogger::XML::API::ua_request( $request );

    Follow the "Test Post" example to create your XML::Atom::Syndication::Entry.

    See Example: WWW::Blogger::XML::parse_test_post_entry( $result );

2. Creating a draft blog post

    TBD

Retrieving posts

1. Retrieving all blog posts

    $request = WWW::Blogger::XML::API::list_of_posts_by_blogid( $blogid );

    $result = WWW::Blogger::XML::API::ua_request( $request );

2. Retrieving posts using query parameters

    $request = WWW::Blogger::XML::API::browse_by_blogid( $blogid, '/Comedy/-dark' );

    -OR-

    $request = WWW::Blogger::XML::API::search_by_blogid( $blogid, 'start-index' => 1, 'max-results' => 10 );

    $result = WWW::Blogger::XML::API::ua_request( $request );

    See: http://code.google.com/apis/blogger/developers_guide_protocol.html#RetrievingWithQuery

Updating posts

    $request = WWW::Blogger::XML::API::get_post_by_blogid_postid( $blogid, $postid );

    $result = WWW::Blogger::XML::API::ua_request( $request );

    ## Edit the Entry, then put the update

    $request = WWW::Blogger::XML::API::put_post_by_blogid_postid( $blogid, $postid, $entry );

    $result = WWW::Blogger::XML::API::ua_request( $request );

Deleting posts

    $request = WWW::Blogger::XML::API::remove_post_by_blogid_postid( $blogid, $postid );

    $result = WWW::Blogger::XML::API::ua_request( $request );

Comments

1. Creating comments

    $request = WWW::Blogger::XML::test_comment_by_blogid_postid( $blogid, $postid );

    -OR-

    $request = WWW::Blogger::XML::API::comment_entry_by_blogid_postid( $blogid, $postid, $entry );

    $result = WWW::Blogger::XML::API::ua_request( $request );

    Follow the "Test Comment" example to create your XML::Atom::Syndication::Entry.

2. Retrieving comments

    $request = WWW::Blogger::XML::API::list_of_comments_by_blogid( $blogid );

    -OR-

    $request = WWW::Blogger::XML::API::list_of_comments_by_blogid_postid( $blogid, $postid );

    $result = WWW::Blogger::XML::API::ua_request( $request );

3. Deleting comments

    $request = WWW::Blogger::XML::API::remove_comment_by_blogid_postid_commentid( $blogid, $postid, $commentid );

    $result = WWW::Blogger::XML::API::ua_request( $request );

SEE ALSO

WWW::Blogger WWW::Blogger::ML::API WWW::Blogger::XML

AUTHOR

 Copyright (C) 2008 Eric R. Meyers E<lt>Eric.R.Meyers@gmail.comE<gt>

2 POD Errors

The following errors were encountered while parsing the POD:

Around line 641:

'=item' outside of any '=over'

Around line 653:

You forgot a '=back' before '=head1'