NAME

       VUser::Google::ProvisioningAPI - Perl module that implements the Google Apps for Your Domain Provisioning
       API

SYNOPSIS

         use VUser::Google::ProvisioningAPI;
         my $google = new VUser::Google::ProvisioningAPI($domain,$admin,$password, $api_version);

         $google->CreateAccount($userName, $firstName, $lastName, $password);
         $google->RetrieveAccount($userName);

REQUIREMENTS

       VUser::Google::ProvisioningAPI requires the following modules to be installed:

       •   "LWP::UserAgent"

       •   "HTTP::Request"

       •   "Encode"

       •   "XML::Simple"

DESCRIPTION

       VUser::Google::ProvisioningAPI::* is depricated in favor of VUser::Google::ApiProtocol and
       VUser::Google::Provisioning.

       VUser::Google::ProvisioningAPI provides a simple interface to the Google Apps for Your Domain
       Provisioning API.  It uses the "LWP::UserAgent" module for the HTTP transport, and the "HTTP::Request"
       module for the HTTP request and response.

CONSTRUCTOR

       new ( $domain, $admin, $adminpassword [,$api_version] )

       This is the constructor for a new VUser::Google::ProvisioningAPI object.  $domain is the domain name
       registered with Google Apps For Your Domain, $admin is an account in the above domain that has the right
       to manage that domain, $adminpassword is the password for that account and $api_version is the version of
       the Google Provisioning API you wish to use. At this time, only '1.0' and '2.0' are supported.

       Note that the constructor will NOT attempt to perform the 'ClientLogin' call to the Google Provisioning
       API.  Authentication happens automatically when the first API call is performed. The token will be
       remembered for the duration of the object, and will be automatically refreshed as needed.  If you want to
       verify that you can get a valid token before performing any operations, follow the constructor with a
       call to IsAuthenticated() as such:

               print "Authentication OK\n" unless not $google->IsAuthenticated();

METHODS

       The methods provided by the object will vary based on the version of the API.  Please see the perldocs
       for specific version you are using. For example, "perldoc VUser::Google::ProvisioningAPI::1.0".

EXPORT

       None by default.

SEE ALSO

       For support, see the Google Group at http://groups.google.com/group/apps-for-your-domain-apis

       VUser::Google::ProvisioningAPI::1.0

       VUser::Google::ProvisioningAPI::2.0

BUGS

       Please report bugs or feature requests at http://code.google.com/p/vuser/issues/list.

AUTHORS

       Johan Reinalda, johan at reinalda dot net

       Randy Smith, perlstalker at vuser dot net

COPYRIGHT AND LICENSE

       Copyright (C) 2006 by Johan Reinalda, johan at reinalda dot net

       Copyright (C) 2007 Randy Smith, perlstalker and 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.