Google Drive

API configuration: google-drive

Features

Features	Status
Auth (OAuth)	✅
Sync data	✅
Perform workflows	✅
Proxy requests	✅
Receive webhooks	🚫 (time to contribute: <48h)

We can implement missing features in <48h, just ask for it in the community.

Getting started

• Google Drive access token specs

• Google Drive OAuth scopes

Need help getting started? Get help in the community.

Pre-built Google Drive integration

Terapi's pre-built Google Drive integration only syncs whitelisted files & folders. You can use the Google Drive Picker to let the customer pick files & folders to sync.

Scope to set: `https://www.googleapis.com/auth/drive.readonly`

In your frontend, run the OAuth flow and show the Google Drive picker to your user.

Example code:
```js
const ingest = async () => 
        }
    } catch (error) 
}

const openGooglePicker = async () =>  else if (data.action == 'picked') 
            }
        });
    });
};
```
Placeholders:
- `` is your App ID. [How to find your app ID](https://stackoverflow.com/a/40638063)
- `` is the client ID of your Google OAuth app.
- `` is the API key for your [Google Picker API](https://developers.google.com/drive/picker/guides/overview).



Pass the user-selected file & folder IDs to your backend.

From there, call the relevant SDK or REST API to store the IDs on the user's connection (SDK example):
```ts
await updateMetadata(
    'google-drive',
    'CONNECTION-ID',
    
);
```



Re-trigger the sync in the dashboard, or with the API or Node SDK. File metadata should get synced.

API gotchas

• Almost all Google Drive scopes are "restricted scopes" by Google. This means your app needs to pass a security review with Google before you can go live with users.

  • The only exception is the drive.file scope, which lets your app access files & folders the user has previously authorized with the Google Drive Picker API.

Add Getting Started links and Gotchas by editing this page.