Cloud Integrations

Supported Providers

Provider	Import	Export	Status
Google Drive	✓	-	Full support
Dropbox	✓	-	Full support
OneDrive	✓	-	Full support
Google Photos	✓	-	Full support

How Cloud Import Works

1. Connect - Authenticate with the cloud provider via OAuth
2. Browse - List files and folders from the connected account
3. Select - Choose which files/folders to import
4. Import - ZeroDrive downloads and stores files in your account
5. Access - Files are now available in your ZeroDrive

Google Drive Integration

Step 1: Connect Account

Redirect the user to initiate OAuth:

This redirects to Google's OAuth consent screen. After authorization, the user is redirected back to ZeroDrive.

Scopes Requested:

• drive.readonly - Read access to files
• drive.file - Access to files created by the app

Step 2: Check Connection Status

Response

Step 3: Browse Google Drive Files

Response

Step 4: Start Import

Parameters

Parameter	Type	Required	Description
provider	string	Yes	google, dropbox, onedrive, or googlePhotos
items	array	Yes	Files/folders to import
destinationFolderId	string	No	Target folder in ZeroDrive

Response

Step 5: Check Import Status

Response

Status Values:

• pending - Job queued
• running - Import in progress
• completed - All items processed
• failed - Import failed

Step 6: Disconnect

Dropbox Integration

Connect

Scopes Requested:

• files.metadata.read
• files.content.read
• files.content.write
• account_info.read

Browse Files

Import Files

Disconnect

OneDrive Integration

Connect

Uses Microsoft Azure AD OAuth.

Scopes Requested:

• Files.Read
• Files.Read.All
• Files.ReadWrite
• Files.ReadWrite.All
• Sites.Read.All
• Sites.ReadWrite.All
• User.Read
• offline_access

Browse Files

Import Files

Disconnect

Google Photos Integration

Connect

Browse Albums & Photos

Import Photos

Disconnect

Import Best Practices

Check Storage Before Import

Handle Large Imports

For many files, import in batches:

Monitor Progress

Error Handling

Connection Errors

Solution: Redirect user to connect endpoint.

Import Already Running

Only one import per provider can run at a time.

Token Expired

Solution: Disconnect and reconnect the provider.

Storage Exceeded

Some files may have been imported before hitting the limit.

Complete Integration Example

Security Notes

1. OAuth tokens are stored securely - Encrypted at rest, never exposed via API
2. Refresh tokens - Long-lived access maintained via refresh tokens
3. Minimal scopes - Only necessary permissions requested
4. Revocation - Disconnecting removes all stored tokens
5. No write access - ZeroDrive only reads from cloud providers, never modifies