com.google.api.client.googleapis.auth.clientlogin

Class ClientLogin

java.lang.Object

com.google.api.client.googleapis.auth.clientlogin.ClientLogin

@Beta
public final class ClientLogin
extends Object

Beta
Client Login authentication method as described in ClientLogin for Installed Applications.

Since:

1.0

Author:

Yaniv Inbar

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ClientLogin.ErrorInfo Key/value data to parse an error response.
static class	ClientLogin.Response Key/value data to parse a success response.

Field Summary

Fields

Modifier and Type	Field and Description
String	accountType Type of account to request authorization for.
String	applicationName Short string identifying your application for logging purposes of the form: "companyName-applicationName-versionID".
String	authTokenType Name of the Google service you're requesting authorization for, for example "cl" for Google Calendar.
String	captchaAnswer (optional) String entered by the user as an answer to a CAPTCHA challenge.
String	captchaToken (optional) Token representing the specific CAPTCHA challenge.
String	password User's password.
com.google.api.client.http.GenericUrl	serverUrl URL for the Client Login authorization server.
com.google.api.client.http.HttpTransport	transport HTTP transport required for executing request in authenticate().
String	username User's full email address.

Constructor Summary

Constructors

Constructor and Description
ClientLogin()

Method Summary

Methods

Modifier and Type	Method and Description
ClientLogin.Response	authenticate() Authenticates based on the provided field values.
static String	getAuthorizationHeaderValue(String authToken) Returns Google Login "Authorization" header value based on the given authentication token.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

transport

public com.google.api.client.http.HttpTransport transport

HTTP transport required for executing request in authenticate().

Since:

1.3

serverUrl

public com.google.api.client.http.GenericUrl serverUrl

URL for the Client Login authorization server.

By default this is "https://www.google.com", but it may be overridden for testing purposes.

Since:

1.3

applicationName

public String applicationName

Short string identifying your application for logging purposes of the form: "companyName-applicationName-versionID".

authTokenType

public String authTokenType

Name of the Google service you're requesting authorization for, for example "cl" for Google Calendar.

username

public String username

User's full email address.

password

public String password

User's password.

accountType

public String accountType

Type of account to request authorization for. Possible values are:

• GOOGLE (get authorization for a Google account only)
• HOSTED (get authorization for a hosted account only)
• HOSTED_OR_GOOGLE (get authorization first for a hosted account; if attempt fails, get authorization for a Google account)

Use HOSTED_OR_GOOGLE if you're not sure which type of account you want authorization for. If the user information matches both a hosted and a Google account, only the hosted account is authorized.

Since:

1.1

captchaToken

public String captchaToken

(optional) Token representing the specific CAPTCHA challenge.

captchaAnswer

public String captchaAnswer

(optional) String entered by the user as an answer to a CAPTCHA challenge.

Constructor Detail

ClientLogin

public ClientLogin()

Method Detail

authenticate

public ClientLogin.Response authenticate()
                                  throws IOException

Authenticates based on the provided field values.

Throws:

ClientLoginResponseException - if the authentication response has an error code, such as for a CAPTCHA challenge.

IOException

getAuthorizationHeaderValue

public static String getAuthorizationHeaderValue(String authToken)

Returns Google Login "Authorization" header value based on the given authentication token.

Since:

1.13