Add Google Drive Account
Google Drive Setup
Section titled “Google Drive Setup”These steps need to be completed within the Google Cloud Console to create a service account that PlaidCloud can use to access Google Drive.
Create a Google Cloud Project
Section titled “Create a Google Cloud Project”- Sign in to the Google Cloud Console
- Create a new project or select an existing one
Enable the Google Drive API
Section titled “Enable the Google Drive API”- Navigate to APIs & Services > Library
- Search for Google Drive API
- Select it and click Enable
Create a Service Account
Section titled “Create a Service Account”- Navigate to APIs & Services > Credentials
- Select + Create Credentials > Service account
- Enter a name for the service account (e.g.
plaidcloud-drive) - Select Create and Continue
- Optionally grant roles (e.g. Viewer for read-only, or Editor for read/write). Select Continue.
- Select Done
Generate a Service Account Key
Section titled “Generate a Service Account Key”- In the Service Accounts list, select the service account you just created
- Navigate to the Keys tab
- Select Add Key > Create new key
- Choose JSON format and select Create
- A JSON key file will download. Save this file securely — it contains the credentials PlaidCloud will use.
Share Drive Content With the Service Account
Section titled “Share Drive Content With the Service Account”- Copy the service account’s email address (e.g.
plaidcloud-drive@your-project.iam.gserviceaccount.com) - In Google Drive, share the folder(s) you want PlaidCloud to access with this email address, granting Editor access. To use a Shared Drive, add the service account as a member of it instead.
You should now have everything you need to add your Google Drive account to PlaidCloud Document.
PlaidCloud Document Setup
Section titled “PlaidCloud Document Setup”- Sign into PlaidCloud
- Select the workspace that the new Document account will reside
- Go to
Document > Manage - Select the New Account button
- Select
Google Driveas the Service Type - Fill in a name and description
- Enter the shared folder path into the Start Path field, or leave it blank to access all shared content
- Select an appropriate Security Model for your use case. Leave it
Privateif unsure. - Paste the entire contents of the JSON key file into the OAuth2 Credentials JSON field under Auth Credentials
- Select the Save button and your new Document account is live
Using the Account in Workflows
Section titled “Using the Account in Workflows”A Google Drive account works in workflows as well as in the Document browser. Steps can list, import, export, copy, move, rename and delete files and create folders.
- Locations. The account’s top-level locations are the folders shared with the service account and the Shared Drives it is a member of. Paths are folder names, such as
Finance/Reports/2026. If two shared folders or Shared Drives have the same name, the account refuses to open that name. Rename or unshare all but one. - Google Sheets. A Google Sheet reads as an
.xlsxexport and appears asName.xlsx. Other Google Workspace files, such as Docs and Slides, can’t be read. - New files in My Drive. A service account has no storage of its own, so in a folder that lives in someone’s personal My Drive it can overwrite an existing file but can’t create a new one. Create the file there first, or use a folder in a Shared Drive, which accepts new files and folders.
- Missing folders. A folder that doesn’t exist lists as empty instead of causing an error.
- Throttling. PlaidCloud retries automatically when Google throttles a request or returns a temporary error.