​
Overview

Pre-built tooling

Pre-built use-cases

Access requirements

Setup guide

Useful links

API gotchas

​
Pre-built tooling

​
Pre-built use cases

Not seeing the use case you need? Build your own independently.

​
Access requirements

Pre-RequisitesStatusComment
Paid dev account❓
Paid test account❓
Partnership❓
App review❓
Security audit❓

​
Setup guide

No setup guide yet.

Need help getting started? Get help in the community.
Contribute improvements to the setup guide by editing this page
Contribute useful links by editing this page

​
Pre-built Google Drive integration

Nango’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.

1

Auth & Show Google Drive Picker

Scope to set in Nango: https://www.googleapis.com/auth/drive.file

In your frontend, run the OAuth flow with nango.auth and show the Google drive picker to your user.

Example code:

const ingest = async () => {
    let filesIds: string[] = [];      
    
    const cid = generateCid(); // generate a unique id for the connection

    try {
    const nangoAuth = await nango.auth('google-drive', cid);
    if (nangoAuth.connectionId) {
        filesIds = await openGooglePicker();
        if(filesIds.length === 0) {
            return;
        }
    }
    } catch (error) {
        // deal with error
    }
}

const openGooglePicker = async (): Promise<string[]> => {
    return new Promise<string[]>((resolve, reject) => {
        openPicker({
            appId: <GOOGLE_APP_ID>, // essential for keeping same file id between nango and your app
            clientId: <GOOGLE_CLIENT_ID>,
            developerKey: <GOOGLE_PICKER_API_KEY>,
            viewId: 'DOCS',
            showUploadView: true,
            showUploadFolders: true,
            supportDrives: true,
            multiselect: true,
            setIncludeFolders: true,
            setSelectFolderEnabled: true,
            callbackFunction: (data) => {
                if (data.action === 'cancel') {
                    handleCancel();
                    resolve([]);
                    return;
                }
                else if (data.action == 'picked') {
                    const fileIds = data.docs.map((doc) => doc.id);
                    resolve(fileIds);
                }
            }
        });
    });
};

Placeholders:

2

Push file & folder IDs to Nango

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

From there, call the Nango SDK or REST API to store the id’s on the user’s connection (SDK example):

await nango.updateMetadata(
    'google-drive',
    'CONNECTION-ID',
    {
         'folders': ['<folder-id>, ...],
        'files': ['<file-id>', ...] 
    }
);
3

Re-trigger the sync

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. It 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

Was this page helpful?

Google DocsGmail