NAME

Net::Google::AuthSub::Response - a response from a Net::Google::AuthSub request

SYNOPSIS

my $response = $auth->login($user, $pass);

if ($response->is_success) {
    print "Yay!\n";
} else {
    if ($response->error eq 'CaptchaRequired') {
        print "Captcha Image ".$response->captchaurl;
    }
}

METHODS

new HTTP::Response base url

Create a new response.

is_success

Returns whether the response was a sucess or not.

SUCCESS METHODS

Methods available if the response was a success.

auth

The authorisation token if the response is a success.

sid

Not used yet.

lsid

Not used yet.

ERROR METHODS

Methods available if the response was an error.

error

The error code. Can be one of

BadAuthentication

The login request used a username or password that is not recognized.

NotVerified

The account email address has not been verified. The user will need to access their Google account directly to resolve the issue before logging in using a non-Google application.

TermsNotAgreed

The user has not agreed to terms. The user will need to access their Google account directly to resolve the issue before logging in using a non-Google application.

CaptchaRequired

A CAPTCHA is required. (A response with this error code will also contain an image URL and a CAPTCHA token.)

Unknown

The error is unknown or unspecified; the request contained invalid input or was malformed.

AccountDeleted

The user account has been deleted.

AccountDisabled

The user account has been disabled.

ServiceDisabled

The user's access to the specified service has been disabled. (The user account may still be valid.)

ServiceUnavailable

The service is not available; try again later.

url

The url of a page describing the error.

captchatoken

The token required to authenticate a captcha.

captchaurl

The full url of the captcha image.