---
name: "VUser::Google::ApiProtocol::V2_0"
section: "3pm"
platform: "linux"
package: "libvuser-google-api-perl"
version: "1.0.1-1.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/VUser::Google::ApiProtocol::V2_0"
---

# VUser::Google::ApiProtocol::V2\_0(3pm)

Implements version 2.0 of the Google APIs.

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