VUser:...ingAPI(3pm)

✨ NAME ✨

VUser::Google::ProvisioningAPI — bestie, it's a Perl module that implements the Google Apps for Your Domain Provisioning API. 💖

(also hi, this is from the VUser:...ingAPI(3pm) manual page, Perl section, come sit with me 🫶)

---

🌸 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);

look at her go. iconic. 💅

---

🎀 REQUIREMENTS 🎀

okay so before you can even use VUser::Google::ProvisioningAPI, you need these modules installed, no skipping:

• LWP::UserAgent
• HTTP::Request
• Encode
• XML::Simple

that's the whole guest list. ✨

---

🦋 DESCRIPTION 🦋

ngl, listen. VUser::Google::ProvisioningAPI::* is depricated (yes, spelled exactly like that in the source, we're keeping it 💀) in favor of VUser::Google::ApiProtocol and VUser::Google::Provisioning. so like… noted. but she's still here and she still works.

VUser::Google::ProvisioningAPI gives you a simple interface to the Google Apps for Your Domain Provisioning API. she uses the LWP::UserAgent module for the HTTP transport, and the HTTP::Request module for the HTTP request and response. that's the whole plumbing situation. 🚰

---

👑 CONSTRUCTOR 👑

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

this is the constructor for a brand new VUser::Google::ProvisioningAPI object. here's the vibe check on each arg:

• $domain — the domain name registered with Google Apps For Your Domain 🌐
• $admin — an account in the above domain that has the right to manage that domain 👑
• $adminpassword — the password for that account 🔐
• $api_version — the version of the Google Provisioning API you wish to use. at this time, only '1.0' and '2.0' are supported. periodt.

⚠️ important bestie: the constructor will NOT attempt to perform the 'ClientLogin' call to the Google Provisioning API. like, it just won't. 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. so she's lowkey self-sufficient, we love that. 🫶

if you really wanna verify that you can get a valid token before performing any operations, follow the constructor with a call to IsAuthenticated() like this:

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

the double negative is giving unhinged but she's valid. 😭✨

---

💅 METHODS 💅

the methods provided by the object will vary based on the version of the API. so please see the perldocs for the specific version you are using. for example, perldoc VUser::Google::ProvisioningAPI::1.0. iykyk. 📚

---

🌈 EXPORT 🌈

None by default. nothing. zero. empty. she gives you nothing unless you ask. 💀

---

⭐ 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. tell them i sent you (i did not send you). 🙈

---

🧚 AUTHORS 🧚

• Johan Reinalda, johan at reinalda dot net
• Randy Smith, perlstalker at vuser dot net

legends, honestly. 👑

---

📜 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.

---

and that's the whole page bestie 💖✨🎀🦋🌸💅🫶

this was perl v5.32.0, dated 2021-01-09, straight out of the VUser:...ingAPI(3pm) manual — no cap. go forth and provision. 👑🌈⭐