Original Google sign in
This module exposes the Google Sign-In for Android (legacy) and Google Sign-In for iOS SDKs.
Please note this documentation is for the latest version of the module which is only available to sponsors ❤️. If you're not a sponsor, read the docs here.
import {
GoogleSignin,
GoogleSigninButton,
statusCodes,
} from '@react-native-google-signin/google-signin';
configure
signature: (options
: ConfigureParams
) => void
It is mandatory to call this method before attempting to call signIn()
and signInSilently()
. This method is sync meaning you can call signIn
/ signInSilently
right after it. In typical scenarios, configure
needs to be called only once, after your app starts. In the native layer, this is a synchronous call. All parameters are optional.
Example usage with default options: you'll get user email and basic profile info.
import { GoogleSignin } from '@react-native-google-signin/google-signin';
GoogleSignin.configure();
An example with all options enumerated:
GoogleSignin.configure({
webClientId: '<FROM DEVELOPER CONSOLE>', // client ID of type WEB for your server. Required to get the `idToken` on the user object, and for offline access.
scopes: ['https://www.googleapis.com/auth/drive.readonly'], // what API you want to access on behalf of the user, default is email and profile
offlineAccess: true, // if you want to access Google API on behalf of the user FROM YOUR SERVER
hostedDomain: '', // specifies a hosted domain restriction
forceCodeForRefreshToken: true, // [Android] related to `serverAuthCode`, read the docs link below *.
accountName: '', // [Android] specifies an account name on the device that should be used
iosClientId: '<FROM DEVELOPER CONSOLE>', // [iOS] if you want to specify the client ID of type iOS (otherwise, it is taken from GoogleService-Info.plist)
googleServicePlistPath: '', // [iOS] if you renamed your GoogleService-Info file, new name here, e.g. GoogleService-Info-Staging
openIdRealm: '', // [iOS] The OpenID2 realm of the home web server. This allows Google to include the user's OpenID Identifier in the OpenID Connect ID token.
profileImageSize: 120, // [iOS] The desired height (and width) of the profile image. Defaults to 120px
});
* forceCodeForRefreshToken docs
signIn
signature: (options
: SignInParams
) => Promise
<User
>
Prompts a modal to let the user sign in into your application. Resolved promise returns an userInfo
object. Rejects with error otherwise.
// import statusCodes along with GoogleSignin
import {
GoogleSignin,
statusCodes,
} from '@react-native-google-signin/google-signin';
// Somewhere in your code
_signIn = async () => {
try {
await GoogleSignin.hasPlayServices();
const userInfo = await GoogleSignin.signIn();
setState({ userInfo, error: undefined });
} catch (error) {
if (isErrorWithCode(error)) {
switch (error.code) {
case statusCodes.SIGN_IN_CANCELLED:
// user cancelled the login flow
break;
case statusCodes.IN_PROGRESS:
// operation (eg. sign in) already in progress
break;
case statusCodes.PLAY_SERVICES_NOT_AVAILABLE:
// play services not available or outdated
break;
default:
// some other error happened
}
} else {
// an error that's not related to google sign in occurred
}
}
};
addScopes
signature: (options
: AddScopesParams
) => Promise
<User
| null
>
This method resolves with user object or with null
if no user is currently logged in.
You may not need this call: you can supply required scopes to the configure
call. However, if you want to gain access to more scopes later, use this call.
Example:
const user = await GoogleSignin.addScopes({
scopes: ['https://www.googleapis.com/auth/user.gender.read'],
});
signInSilently
signature: () => Promise
<User
>
May be called e.g. after of your main component mounts. This method returns a Promise
that resolves with the current user and rejects with an error otherwise.
To see how to handle errors read signIn()
method
const getCurrentUserInfo = async () => {
try {
const userInfo = await GoogleSignin.signInSilently();
setState({ userInfo });
} catch (error) {
if (error.code === statusCodes.SIGN_IN_REQUIRED) {
// user has not signed in yet
} else {
// some other error
}
}
};
hasPreviousSignIn
signature: () => boolean
This synchronous method may be used to find out whether some user previously signed in.
Note that hasPreviousSignIn()
can return true
but getCurrentUser()
can return null
, in which case you can call signInSilently()
to recover the user.
However, it may happen that calling signInSilently()
rejects with an error (e.g. due to a network issue).
const hasPreviousSignIn = async () => {
const hasPreviousSignIn = GoogleSignin.hasPreviousSignIn();
setState({ hasPreviousSignIn });
};
getCurrentUser
signature: () => User
| null
This is a synchronous method that returns null
or userInfo
object of the currently signed-in user.
const getCurrentUser = async () => {
const currentUser = GoogleSignin.getCurrentUser();
setState({ currentUser });
};
clearCachedAccessToken
signature: (accessTokenString
: string
) => Promise
<null
>
This method only has an effect on Android. You may run into a 401 Unauthorized
error when a token is invalid. Call this method to remove the token from local cache and then call getTokens()
to get fresh tokens. Calling this method on iOS does nothing and always resolves. This is because on iOS, getTokens()
always returns valid tokens, refreshing them first if they have expired or are about to expire (see docs).
getTokens
signature: () => Promise
<GetTokensResponse
>
Resolves with an object containing { idToken: string, accessToken: string, }
or rejects with an error. Note that using accessToken
for identity assertion on your backend server is discouraged.
signOut
signature: () => Promise
<null
>
Signs out the current user.
const signOut = async () => {
try {
await GoogleSignin.signOut();
setState({ user: null }); // Remember to remove the user from your app's state as well
} catch (error) {
console.error(error);
}
};
revokeAccess
signature: () => Promise
<null
>
Removes your application from the user authorized applications. Read more about it here and here.
const revokeAccess = async () => {
try {
await GoogleSignin.revokeAccess();
// Google Account disconnected from your app.
// Perform clean-up actions, such as deleting data associated with the disconnected account.
} catch (error) {
console.error(error);
}
};