Shared Drive Membership Required

Resolve permission errors during Google Team Drive migration.

Last updated: 2025-01-15 Troubleshooting

Error Message

Google Drive Migration Error

The attempted action requires shared drive membership. [403]

This fatal error prevents the migration from completing for the affected Team Drive.

Permission Requirement

👤
Migration Account
Service account
→
🚫
No Access
Not a member
→
✓
Add as Organizer
Required role

Root Cause

Insufficient Permissions

This error occurs when the migration account (service account) doesn't have membership in the Google Shared Drive (Team Drive) being migrated. Google requires at minimum organizer-level access to perform migration operations.

Google's Requirement

To read all files, manage permissions, and access the complete folder structure, the migration account must be an Organizer (also called Manager) of the Shared Drive.

Solutions

Option 1: Manually Add as Organizer

Add the migration service account as an organizer of the Google Team Drive before initiating the migration.

1

Open Google Drive and navigate to Shared Drives

2

Right-click the Team Drive and select "Manage members"

3

Add the service account email with Manager role

4

Retry the migration

Option 2: Use Full Drive Scope

Configure the service account with the full "Drive" scope instead of "Drive.ReadOnly". This allows Cloudiway to automatically grant organizer status to the service account.

Required API Scope

https://www.googleapis.com/auth/drive

The limited Drive.ReadOnly scope lacks the necessary authorization for Team Drive operations.

Best Practice

For large migrations with many Team Drives, use the full Drive scope so Cloudiway can automatically manage permissions. For smaller migrations, manually adding the service account as an organizer works well.

Was this article helpful?

We value your feedback

Help us improve your experience

What would you like to share with us?

Need direct support? Open a ticket