NAME

WWW::Google::APIDiscovery - Interface to Google API Discovery Service.

VERSION

Version 0.05

DESCRIPTION

The Google APIs Discovery Service allows you to interact with Google APIs by exposing machine readable metadata about other Google APIs through a simple API. Currently supports version v1.

IMPORTANT:The version v1 of the Google APIs Discovery Service is in Labs & its features might change unexpectedly until it graduates.

    +----------------------------------+
    | Supported APIs                   |
    +----------------------------------+
    | Google Buzz                      |
    | Google Custom Search             | 
    | Google Diacritize                | 
    | Google Page Speed Online         |
    | Google Prediction                |
    | Google URL Shortener             |
    +----------------------------------+

CONSTRUCTOR

The constructor expects the name of API, you want to know about. Below is valid list of keys.

    +-----------------+---------------------------+
    | Key             |                           |
    +-----------------+---------------------------+
    | buzz            | Google Buzz               | 
    | customsearch    | Google Custom Search      | 
    | diacritize      | Google Diacritize         | 
    | pagespeedonline | Google Page Speed Online  | 
    | prediction      | Google Prediction         |
    | urlshortener    | Google URL Shortener      | 
    +-----------------+---------------------------+

    use strict; use warnings;
    use WWW::Google::APIDiscovery;
    
    my ($api);
    $api = WWW::Google::APIDiscovery->new('buzz');
    # or
    $api = WWW::Google::APIDiscovery->new(api => 'buzz');
    # or
    $api = WWW::Google::APIDiscovery->new({api => 'buzz'});

METHODS

discover()

Returns result object of type WWW::Google::APIDiscovery::Result which can be probed further for more information.

    use strict; use warnings;
    use WWW::Google::APIDiscovery;
    
    my $api = WWW::Google::APIDiscovery->new('buzz');
    my $result = $api->discover();
    print "Title: [" . $result->api_title() . "]\n";

AUTHOR

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

BUGS

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

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Google-APIDiscovery

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/WWW-Google-APIDiscovery

• CPAN Ratings

  http://cpanratings.perl.org/d/WWW-Google-APIDiscovery

• Search CPAN

  http://search.cpan.org/dist/WWW-Google-APIDiscovery/

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.

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.