NAME

       VUser::Google::ApiProtocol::V2_0 - Implements version 2.0 of the Google APIs.

SYSNOPSIS

        use VUser::Google::ApiProtocol::V2_0;

        ## Create a new connection
        my $google = VUser::Google::ApiProtocol::V2_0->new(
            domain   => 'your.google-apps-domain.com',
            admin    => 'admin_user',
            password => 'admin_user password',
        );

        ## Login to the Google Apps API
        # Login() uses the credentials provided in new()
        $google->Login();

        ## Create a new request
        # Create the URL to send to API request to.
        # See the API docs for the valid URLs
        my $url = "https://apps-apis.google.com/a/feeds/emailsettings/2.0/"
        $url   .= "your.google-apps-domain.com/username/label";

        # Create XML message to send to Google
        # See the API docs for the valid XML to send
        my $xml = '<?xml version="1.0" encoding="utf-8"?>...';

        # NB: The method (POST here) may be different depending on API call
        my $success = $google->Request('POST', $url, $xml);

        # Get the parsed response
        if ($success) {
            # $result is the XML reply parsed by XML::Simple
            my $result = $google->get_result;
        }
        else {
            # $result is the error message from google
            # parsed by XML::Simple with the addition of a
            # 'reason' key which contains the error.
            my $result = $google->get_result;
            die "Error: $result->{reason}";
        }

DESCRIPTION

       Implements version 2.0 of the Google API. See VUser::Google::ApiProtocol for a list of
       members and methods.

SEE ALSO

       VUser::Google::ApiProtocol, XML::Simple

AUTHOR

       Randy Smith <perlstalker@vuser.org>

       Adapted from code from Johan Reinalda <johan@reinalda.net>

LICENSE

       Copyright (C) 2006 by Johan Reinalda, johan at reinalda dot net Copyright (C) 2009 by
       Randy Smith, perlstalker at vuser dot org

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself, either Perl version 5.8.5 or, at your option, any later version of
       Perl 5 you may have available.

       If you make useful modification, kindly consider emailing then to me for inclusion in a
       future version of this module.