Setting up Google Drive Sync (Bring Your Own Credentials)
Last updated: 2026-07-28
To sync a local vault with your Google Drive in Plainva, you can use your own Google API credentials. Since Plainva has not (yet) gone through Google’s central CASA verification, this Bring Your Own Credentials (BYO) approach offers a safe way to sync your private files.
You essentially set up your own little “developer project” at Google that belongs to you alone and that only you can access.
Step-by-step guide
1. Create a project in the Google Cloud Console
- Go to the Google Cloud Console.
- Sign in with your Google account.
- At the top left (next to the Google Cloud logo), open the project dropdown and choose New Project.
- Enter a name (e.g. “Plainva Sync”) and click Create.
2. Enable the Google Drive API
- Select your newly created project in the dropdown at the top.
- Search for Google Drive API in the top search bar and pick the entry under “Marketplace”.
- Click Enable.
3. Configure the OAuth consent screen
For Plainva to use your credentials, a consent screen (“OAuth Consent Screen”) must be set up. Since only you use the app, it stays in “testing” mode.
- In the left side menu under APIs & Services, open OAuth consent screen.
- Under “User Type” choose External (unless you use Google Workspace) and click Create.
- App information:
- App name: e.g. “Plainva”
- User support email: your own email
- Developer contact information: your own email
- Click Save and Continue.
- Scopes:
- Click Add or Remove Scopes.
- Search for
.../auth/drive(Google Drive API, full access) and tick the box. - Background: full access is needed so Plainva can also sync files that you drop into your sync folder via the Google Drive web interface.
- Click Update, then Save and Continue.
- Test users:
- Click Add Users.
- Enter exactly the Google email address you will later use for sync in Plainva.
- Click Save and Continue, then return to the dashboard.
Important: you do NOT need to publish the app — it works fully in “Testing” status. Expect Google to expire the sign-in after 7 days in that case, and for good: in this mode the refresh token expires too, so Plainva cannot renew it in the background. Plainva says so in plain words (“sign-in expired”), and Sign in again in the account details restores it in one round trip for every service of that account.
If you would rather not do that every week, set the app to In production (“Publish app”) in the console: the sign-in then stays valid. You do not need Google to verify you for this — for an unverified app the sign-in shows a warning screen once, which you confirm as its owner via “Advanced”.
4. Create credentials (Client ID & Secret)
- Open Credentials in the left menu.
- Click Create Credentials at the top and choose OAuth client ID.
- As the “Application type” choose Desktop app (or “Other UI”).
- Name: e.g. “Plainva Desktop Client”.
- Click Create.
- A popup shows your Client ID and Client Secret.
5. Enter them in Plainva
- Open Plainva and go to the vault settings (gear icon for the vault in question).
- Open the Cloud Sync section.
- Choose Google Drive as the provider.
- Paste the copied Client ID and Client Secret into the corresponding fields.
- Click Connect to Google.
- A Google browser window opens. Sign in with the account you added under “Test users”.
- Google may warn that the app is unverified. Click Advanced and then Continue to Plainva (unsafe).
- Confirm the requested permissions.
Your vault now syncs safely with Google Drive through your own credentials.