com.google.auth.oauth2

Class UserCredentials

java.lang.Object

com.google.auth.Credentials

com.google.auth.oauth2.OAuth2Credentials

com.google.auth.oauth2.GoogleCredentials

com.google.auth.oauth2.UserCredentials

All Implemented Interfaces:

Serializable

public class UserCredentials
extends GoogleCredentials

OAuth2 Credentials representing a user's identity and consent.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UserCredentials.Builder

Nested classes/interfaces inherited from class com.google.auth.oauth2.OAuth2Credentials

OAuth2Credentials.CredentialsChangedListener

Constructor Summary

Constructors

Constructor and Description
UserCredentials(String clientId, String clientSecret, String refreshToken) Deprecated. Use newBuilder() instead. This constructor will either be deleted or made private in a later version.
UserCredentials(String clientId, String clientSecret, String refreshToken, AccessToken accessToken) Deprecated. Use newBuilder() instead. This constructor will either be deleted or made private in a later version.
UserCredentials(String clientId, String clientSecret, String refreshToken, AccessToken accessToken, HttpTransportFactory transportFactory, URI tokenServerUri) Deprecated. Use newBuilder() instead. This constructor will either be deleted or made private in a later version.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
static UserCredentials	fromStream(InputStream credentialsStream) Returns credentials defined by a JSON file stream using the format supported by the Cloud SDK.
static UserCredentials	fromStream(InputStream credentialsStream, HttpTransportFactory transportFactory) Returns credentials defined by a JSON file stream using the format supported by the Cloud SDK.
String	getClientId() Returns client ID of the credential from the console.
String	getClientSecret() Returns client secret of the credential from the console.
String	getRefreshToken() Returns the refresh token resulting from a OAuth2 consent flow.
int	hashCode()
static UserCredentials.Builder	newBuilder()
AccessToken	refreshAccessToken() Refreshes the OAuth2 access token by getting a new access token from the refresh token
void	save(String filePath) Saves the end user credentials into the given file path.
UserCredentials.Builder	toBuilder()
String	toString()

Methods inherited from class com.google.auth.oauth2.GoogleCredentials

create, createDelegated, createScoped, createScopedRequired, getApplicationDefault, getApplicationDefault, of

Methods inherited from class com.google.auth.oauth2.OAuth2Credentials

addChangeListener, getAccessToken, getAuthenticationType, getFromServiceLoader, getRequestMetadata, getRequestMetadata, getRequestMetadataInternal, hasRequestMetadata, hasRequestMetadataOnly, newInstance, refresh, removeChangeListener

Methods inherited from class com.google.auth.Credentials

blockingGetToCallback, getRequestMetadata

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

UserCredentials

@Deprecated
public UserCredentials(String clientId,
                                   String clientSecret,
                                   String refreshToken)

Deprecated. Use newBuilder() instead. This constructor will either be deleted or made private in a later version.

Constructor with minimum information and default behavior.

Parameters:

clientId - Client ID of the credential from the console.

clientSecret - Client ID of the credential from the console.

refreshToken - A refresh token resulting from a OAuth2 consent flow.

UserCredentials

@Deprecated
public UserCredentials(String clientId,
                                   String clientSecret,
                                   String refreshToken,
                                   AccessToken accessToken)

Deprecated. Use newBuilder() instead. This constructor will either be deleted or made private in a later version.

Constructor to allow both refresh token and initial access token for 3LO scenarios.

Parameters:

clientId - Client ID of the credential from the console.

clientSecret - Client ID of the credential from the console.

refreshToken - A refresh token resulting from a OAuth2 consent flow.

accessToken - Initial or temporary access token.

UserCredentials

@Deprecated
public UserCredentials(String clientId,
                                   String clientSecret,
                                   String refreshToken,
                                   AccessToken accessToken,
                                   HttpTransportFactory transportFactory,
                                   URI tokenServerUri)

Deprecated. Use newBuilder() instead. This constructor will either be deleted or made private in a later version.

Constructor with all parameters allowing custom transport and server URL.

Parameters:

clientId - Client ID of the credential from the console.

clientSecret - Client ID of the credential from the console.

refreshToken - A refresh token resulting from a OAuth2 consent flow.

accessToken - Initial or temporary access token.

transportFactory - HTTP transport factory, creates the transport used to get access tokens.

tokenServerUri - URI of the end point that provides tokens.

Method Detail

fromStream

public static UserCredentials fromStream(InputStream credentialsStream)
                                  throws IOException

Returns credentials defined by a JSON file stream using the format supported by the Cloud SDK.

Parameters:

credentialsStream - the stream with the credential definition.

Returns:

the credential defined by the credentialsStream.

Throws:

IOException - if the credential cannot be created from the stream.

fromStream

public static UserCredentials fromStream(InputStream credentialsStream,
                                         HttpTransportFactory transportFactory)
                                  throws IOException

Returns credentials defined by a JSON file stream using the format supported by the Cloud SDK.

Parameters:

credentialsStream - the stream with the credential definition.

transportFactory - HTTP transport factory, creates the transport used to get access tokens.

Returns:

the credential defined by the credentialsStream.

Throws:

IOException - if the credential cannot be created from the stream.

refreshAccessToken

public AccessToken refreshAccessToken()
                               throws IOException

Refreshes the OAuth2 access token by getting a new access token from the refresh token

Overrides:

refreshAccessToken in class OAuth2Credentials

Throws:

IOException - from derived implementations

getClientId

public final String getClientId()

Returns client ID of the credential from the console.

Returns:

client ID

getClientSecret

public final String getClientSecret()

Returns client secret of the credential from the console.

Returns:

client secret

getRefreshToken

public final String getRefreshToken()

Returns the refresh token resulting from a OAuth2 consent flow.

Returns:

refresh token

save

public void save(String filePath)
          throws IOException

Saves the end user credentials into the given file path.

Parameters:

filePath - Path to file where to store the credentials

Throws:

IOException - An error storing the credentials.

hashCode

public int hashCode()

Overrides:

hashCode in class OAuth2Credentials

toString

public String toString()

Overrides:

toString in class OAuth2Credentials

equals

public boolean equals(Object obj)

Overrides:

equals in class OAuth2Credentials

newBuilder

public static UserCredentials.Builder newBuilder()

toBuilder

public UserCredentials.Builder toBuilder()

Overrides:

toBuilder in class GoogleCredentials