Google Drive

Integrate your application with the Google Drive API

🚀 Quickstart

Connect to Google Drive with Nango and see data flow in 2 minutes.

1. Create the integration

   In Nango (free signup), go to Integrations -> Configure New Integration -> Google Drive.

   Nango has credentials you can use for testing. Activate them in the dashboard.

2. Authorize Google Drive

   Go to Connections -> Add Test Connection -> Authorize, then log in to Google Drive. Later, you’ll let your users do the same directly from your app.

3. Call the Google Drive API

   Let’s make your first request to the Google Drive API (fetch a list of files). Replace the placeholders below with your secret key, integration ID, and connection ID:

   cURL

   curl "https://api.nango.dev/proxy/drive/v3/files?pageSize=10" \
     -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
     -H "Provider-Config-Key: <INTEGRATION-ID>" \
     -H "Connection-Id: <CONNECTION-ID>"
   

   Node

   Install Nango’s backend SDK with npm i @nangohq/node. Then run:

   import { Nango } from '@nangohq/node';
   
   const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
   
   const res = await nango.get({
       endpoint: '/drive/v3/files',
       params: { pageSize: 10 },
       providerConfigKey: '<INTEGRATION-ID>',
       connectionId: '<CONNECTION-ID>'
   });
   
   console.log(res.data);
   

   Or fetch credentials with the Node SDK or API.

   ✅ You’re connected! Check the Logs tab in Nango to inspect requests.

4. Implement Nango in your app

   Follow our Auth implementation guide to integrate Nango in your app.

   To obtain your own production credentials, follow the setup guide linked below.

📚 Google Drive Integration Guides

Nango maintained guides for common use cases.

• How to register your own Google Drive OAuth app
  Register an OAuth app with Google Drive and obtain credentials to connect it to Nango

• Complete integration example with the Nango Sample App
  See a production-ready Google Drive integration with file picker, webhooks, and file syncing. Includes a demo video walkthrough and GitHub repository.

Official docs: Google Drive API Documentation

🧩 Pre-built syncs & actions for Google Drive

Enable them in your dashboard. Extend and customize to fit your needs.

Changes

Function name	Description	Type	Source code
get-changes-start-page-token	Get the starting token for listing future changes	Action	🔗 Github
list-changes	List changes to files and shared drives	Action	🔗 Github

Comments

Function name	Description	Type	Source code
create-comment	Add a comment to a file	Action	🔗 Github
delete-comment	Delete a comment from a file	Action	🔗 Github
get-comment	Get a comment by ID	Action	🔗 Github
list-comments	List comments on a file	Action	🔗 Github
update-comment	Update a comment on a file	Action	🔗 Github

Documents

Function name	Description	Type	Source code
documents	Sync file metadata for IDs in connection metadata files, or recursively for all files under folder IDs in folders. Supports shared drives.	Sync	🔗 Github

Drive

Function name	Description	Type	Source code
create-folder	Create a new folder in Google Drive	Action	🔗 Github
get-about	Get the user’s drive info and storage quota	Action	🔗 Github

Drives

Function name	Description	Type	Source code
create-shared-drive	Create a shared drive	Action	🔗 Github
delete-shared-drive	Delete a shared drive	Action	🔗 Github
get-shared-drive	Get a shared drive by ID	Action	🔗 Github
list-drives	List shared drives the user can access, with cursor pagination and drive metadata like hidden, capabilities, and restrictions.	Action	🔗 Github

Files

Function name	Description	Type	Source code
copy-file	Copy a file to a destination	Action	🔗 Github
delete-file	Delete a file or folder from Google Drive	Action	🔗 Github
empty-trash	Permanently delete all trashed files	Action	🔗 Github
find-file	Search for files by name or query in Google Drive	Action	🔗 Github
get-revision	Get a file revision by ID	Action	🔗 Github
list-files-non-unified	List immediate files and folders for a folder ID, or root when omitted, with cursor pagination and shared-drive support.	Action	🔗 Github
move-file	Move a file to a different folder	Action	🔗 Github
update-file	Update a file’s metadata	Action	🔗 Github
upload-document	Upload plain text or base64 file content up to 5 MB, optionally into a folder with a description; defaults to root	Action	🔗 Github

Folders

Function name	Description	Type	Source code
find-folder	Search for a folder by name or query	Action	🔗 Github
folders	Sync root-level Google Drive folders from My Drive and shared drives	Sync	🔗 Github

Permissions

Function name	Description	Type	Source code
delete-permission	Remove a permission from a file	Action	🔗 Github
get-permission	Get a permission by ID	Action	🔗 Github
list-permissions	List permissions on a file	Action	🔗 Github
update-permission	Update a permission on a file	Action	🔗 Github
permissions	Sync file permissions from Google Drive	Sync	🔗 Github

Shared Drives

Function name	Description	Type	Source code
hide-shared-drive	Hide a shared drive from the default view	Action	🔗 Github
unhide-shared-drive	Restore a hidden shared drive to default view	Action	🔗 Github
update-shared-drive	Update a shared drive’s metadata	Action	🔗 Github
shared-drives	Sync shared drives from Google Drive	Sync	🔗 Github

---