Google Drive权限复制报错：emailAddress字段必填问题排查

核心问题原因 #

1. Drive API v3 默认不返回敏感字段：调用Drive.Permissions.list时，默认响应不会包含emailAddress或userId这类敏感信息，导致你读取到的permission.emailAddress为空。
2. 用户/组权限的必填规则：API明确要求，创建user或group类型的权限时，必须提供emailAddress或userId二者之一，你的代码因缺少有效标识字段触发400错误。

解决方案 #

1. 修改权限列表请求，指定返回所需字段 #

在调用Drive.Permissions.list时添加fields参数，明确要求返回权限的标识信息（userId、emailAddress等），否则API不会主动返回这些敏感字段。

2. 优先使用userId创建权限 #

userId是用户的永久唯一标识，比emailAddress更可靠（避免邮箱变更导致权限失效），创建权限时优先使用userId，无userId时再 fallback 到emailAddress。

修正后的完整代码 #

function copyPermissionsUsingDriveAPI(sourceId, targetId) {
    try {
        // 关键：添加fields参数获取权限的完整标识信息
        const permissionsResponse = Drive.Permissions.list(sourceId, { 
            supportsAllDrives: true,
            fields: 'permissions(id,role,type,emailAddress,userId,allowFileDiscovery)'
        });

        const permissions = permissionsResponse.permissions || [];
        if (!permissions.length) return;

        const nonOwnerPermissions = permissions.filter(permission => permission.role !== 'owner');
        if (!nonOwnerPermissions.length) return;

        nonOwnerPermissions.forEach(permission => {
            try {
                const newPermission = {
                    role: permission.role,
                    type: permission.type
                };

                if (permission.type === 'anyone') {
                    newPermission.allowFileDiscovery = permission.allowFileDiscovery || false;
                } else if (permission.type === 'user' || permission.type === 'group') {
                    // 优先使用userId，无userId则用emailAddress
                    if (permission.userId) {
                        newPermission.userId = permission.userId;
                    } else if (permission.emailAddress) {
                        newPermission.emailAddress = permission.emailAddress;
                    } else {
                        Logger.log('Skipping permission: no valid user/group identifier found');
                        return;
                    }
                }

                const url = `https://www.googleapis.com/drive/v3/files/${targetId}/permissions`;
                const options = {
                    method: 'post',
                    contentType: 'application/json',
                    headers: {
                        Authorization: `Bearer ${ScriptApp.getOAuthToken()}`
                    },
                    payload: JSON.stringify(newPermission),
                    muteHttpExceptions: true // 可选：获取完整错误响应便于调试
                };

                const response = UrlFetchApp.fetch(url, options);
                if (response.getResponseCode() !== 200) {
                    Logger.log(`Permission failed: ${response.getContentText()}`);
                }
            } catch (error) {
                Logger.log(`Error setting permissions: ${error.message}`);
            }
        });
    } catch (error) {
        Logger.log(`Error fetching permissions: ${error.message}`);
    }
}

额外注意事项 #

• 权限范围：确保脚本拥有https://www.googleapis.com/auth/drive权限（或更细粒度的drive.file权限，需保证能访问源文件和目标文件的权限信息）。
• 团队盘限制：如果源文件在团队盘中，部分严格的共享设置可能会隐藏emailAddress，此时userId是更可靠的标识。
• 调试优化：开启muteHttpExceptions: true可以获取完整的错误响应，方便排查其他潜在问题。

内容的提问来源于stack exchange，提问作者Xavier Helms