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.