Create a google app
To enable Google Drive backups you will need to create a Google Project within your organization that will act as the OAuth consumer.
- Create a new Google project in the Google Cloud Console
- On the APIs & Services page click
ENABLE APIS AND SERVICES
- Search for
Google Drive API, select it, and click Enable
- Click on OAuth consent screen
- For user type select internal.
- Fill out the relevant information.
- Our SDKs request Drive scopes per backup option (see the per-option scope table in the iOS and Android backup guides). Configure both scopes on your OAuth consent screen so any backup option works:
-
At runtime, users only see consent checkboxes for the scopes their configured backup option needs. The hidden app-data option (
appDataFolder) requests only drive.appdata, the user-visible folder option (gdriveFolder on iOS, CustomFolder on Android) requests only drive.file, and appDataFolderWithFallback requests both. Both scopes are in Google’s non-sensitive category.
-
Click on Credentials in the left menu and select
+ Create Credentials
Before going to production, you’ll need to verify your application and update your User type to External in order to allow external users to authenticate with Google.
- Select
OAuth client ID and choose Android from the Application Type list
- Fill in the form as instructed, with
Name, Package name, and SHA-1 from your Keystore.
- Note that when testing you’ll want to use your debug.keystore at /android/app/debug.keystore; However, you’ll need to switch this value when pushing it to the store.
- Find the Sha-1 fingerprint with this command from the root project folder:
keytool -keystore ./app/debug.keystore -list -v
- Click on Credentials in the left menu, select
+ Create Credentials again, and select Oauth client ID again. Then select Web Application as the Application type.
- Input the
Name. Then click create and copy the value from Your Client ID.
- This value is what you will pass into the
PortalOptions config when instantiating your Portal class.
- Important: Add emails for internal testing until you’ve published your app for external use.
- Select
OAuth client ID and choose iOS from the Application Type list
- Get your
Bundle ID from the react-native / iOS project
- Once you’ve successfully created your iOS client ID, download the .plist config and copy the
REVERSED_CLIENT_ID to the URL Scheme section of your info.plist either in xcode or your IDE:
- Rename the downloaded
.plist file to GoogleService-Info.plist and save that to your /ios directory
- Copy and paste the
Client ID from the GoogleService-Info.plistinto the PortalOptions config object when instantiating your portal class
Useful Google Resources
Should I set scopes in the OAuth Consent Screen?
- Our backup method does not require any sensitive or restrictive scopes as defined by google; however, setting scopes for your application will limit the functionality to only what is required from the permission if the temporary auth token was to get compromised. It is recommended by google to register all scopes
Should I get google approval?
- You do not need to in order to publish your app because we don’t require sensitive or restrictive scopes; however, if you would like brand verification you will need to get google permissions. Those times vary from a couple days to two weeks. Google docs
