The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
WWW-Google-Buzz-0.02
++
/ WWW::Google::Buzz

NAME

WWW::Google::Buzz - Interface to Google Buzz API.

VERSION

Version 0.02

DESCRIPTION

This module is intended for anyone who wants to write applications that can interact with the Google Buzz API. Google Buzz is a tool for sharing updates, photos, videos and more, and participating in conversations about things which is interesting.This can be used to create to search activities & public activities of any Google Buzz user programmatically.However I would be adding the ability to create, update and add comment very soon. Courtesy limit is 1000000 queries per day. Currently it supports version v1.

IMPORTANT: The version v1 of the Google Buzz API is in Labs, and its features might change unexpectedly until it graduates.

CONSTRUCTOR

The constructor expects your application API, which you can get it for FREE from Google.

    use strict; use warnings;
    use WWW::Google::Buzz;

    my $api_key = 'Your_API_Key';
    my $buzz    = WWW::Google::Buzz->new($api_key);

METHODS

search_activities()

Search activies using the given query string. This method accepts the following parameters as mentioned in the below table. The key 'q' is mandatory.

    +----------------+-----------------------------------------------+------------+---------+
    | Key            | Description                                   | Values     | Default |
    +----------------+-----------------------------------------------+------------+---------+
    | alt            | Specifies an alternative representation type. | atom/json  | atom    |
    | prettyprint    | If true,the response will include indentations| true/false | false   |
    |                | and line breaks to make it human readable.    |            |         |
    | q              | Specifies a full-text query string.           |            |         |
    | lon,lat,radius | Specifies geographical location by lon, lat   |            |         |
    |                | and radius.                                   |            |         |
    | bbox           | Accepts two pairs of geographic coordinates   |            |         |
    |                | which identify the southwest and northeast    |            |         |
    |                | corners of the rectangular bounding region    |            |         |
    |                | and takes the form lon1,lat1,lon2,lat2.       |            |         |
    | pid            | Takes the reference value for a place, as     |            |         |
    |                | provided by the Places Web Service.           |            |         |
    +----------------+-----------------------------------------------+------------+---------+

    use strict; use warnings;
    use WWW::Google::Buzz;

    my $api_key = 'Your_API_Key';
    my $buzz    = WWW::Google::Buzz->new($api_key);
    print $buzz->search_activities({q => 'London', prettyprint=>'true'});

get_public_activities()

Search public activies for the given userId. This method accepts the following parameters as mentioned in the below table. The key 'user_id' is mandatory.

    +----------------+-----------------------------------------------+------------+---------+
    | Key            | Description                                   | Values     | Default |
    +----------------+-----------------------------------------------+------------+---------+
    | user_id        | userId of the owner of activities.            | googlebuzz |         |
    | alt            | Specifies an alternative representation type. | atom/json  | atom    |
    | prettyprint    | If true,the response will include indentations| true/false | false   |
    |                | and line breaks to make it human readable.    |            |         |
    +----------------+-----------------------------------------------+------------+---------+

    use strict; use warnings;
    use WWW::Google::Buzz;

    my $api_key = 'Your_API_Key';
    my $buzz    = WWW::Google::Buzz->new($api_key);
    print $buzz->get_public_activities({user_id => 'googlebuzz', prettyprint=>'true'});

AUTHOR

Mohammad S Anwar, <mohammad.anwar at yahoo.com>

BUGS

Please report any bugs or feature requests to bug-www-google-buzz at rt.cpan.org or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Google-Buzz. I will be notified & 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 WWW::Google::Buzz

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright 2011 Mohammad S Anwar.

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.

By using the Google Buzz API, you agree to the Google Buzz API Terms of Service and agree to abide by the Google Buzz Developer Policies.

http://code.google.com/apis/buzz/terms.html http://code.google.com/apis/buzz/policies.html

DISCLAIMER

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.