C#桌面应用如何通过Drive.File权限仅访问指定Google Sheet？

核心逻辑梳理 #

Drive.File权限的核心规则是：应用仅能访问用户主动授权的文件或应用自身创建的文件。你之前使用的Spreadsheets是全范围权限，切换到Drive.File后必须让用户明确授予目标Sheet的访问权，LoginHint参数无法解决这个问题。

具体解决方案步骤 #

1. 替换认证权限范围
   把原代码中的SheetsService.Scope.Spreadsheets替换为DriveService.Scope.DriveFile，该权限允许应用对用户授权的文件执行读写操作（包含Sheets的单元格编辑）。

2. 验证目标文件权限
   用户提供Sheet URL后，先提取文件ID，再通过Drive API检查当前应用是否已有该文件的读写权限。如果无权限，立即引导用户授权。

3. 引导用户授权目标文件
   最直接的方式是使用Google Picker（桌面应用可通过打开默认浏览器加载Picker页面），让用户主动选择目标Sheet。用户选择完成后，应用自动获得该文件的访问权限，无需发送共享邮件。

调整后的代码示例 #

1. 修改认证逻辑

public async Task AuthGoogleDriveFile(CancellationToken cancellationToken)
{
    using (var stream = new FileStream(CredentialsFilePath, FileMode.Open, FileAccess.Read))
    {
        _googleCreds = await GoogleWebAuthorizationBroker.AuthorizeAsync(
            GoogleClientSecrets.FromStream(stream).Secrets,
            new[] { DriveService.Scope.DriveFile }, // 切换为Drive.File权限
            "user",
            cancellationToken,
            new FileDataStore(AuthTokenFilePath));

        await _googleCreds.RefreshTokenAsync(cancellationToken);
    }

    // 同时初始化DriveService和SheetsService
    driveService = new DriveService(new BaseClientService.Initializer()
    {
        HttpClientInitializer = _googleCreds,
        ApplicationName = "myappname",
    });

    sheetsService = new SheetsService(new BaseClientService.Initializer()
    {
        HttpClientInitializer = _googleCreds,
        ApplicationName = "myappname",
    });
}

2. 提取Sheet文件ID并检查权限

// 从Sheet URL中提取文件ID
public string GetSheetFileId(string sheetUrl)
{
    var uri = new Uri(sheetUrl);
    var segments = uri.Segments;
    var dIndex = Array.IndexOf(segments, "d/");
    if (dIndex != -1 && dIndex + 1 < segments.Length)
    {
        return segments[dIndex + 1].TrimEnd('/');
    }
    throw new ArgumentException("无效的Google Sheet链接");
}

// 检查应用是否拥有文件读写权限
public async Task<bool> HasFileWritePermission(string fileId, CancellationToken cancellationToken)
{
    try
    {
        var permission = await driveService.Permissions.Get(fileId, "me").ExecuteAsync(cancellationToken);
        return permission.Role is "writer" or "owner";
    }
    catch (GoogleApiException ex)
    {
        // 403/404代表无权限或文件不存在
        if (ex.HttpStatusCode == System.Net.HttpStatusCode.Forbidden || 
            ex.HttpStatusCode == System.Net.HttpStatusCode.NotFound)
        {
            return false;
        }
        throw;
    }
}

3. 引导用户通过Picker授权文件

桌面应用中，你可以构造Google Picker的URL（带上你的客户端ID和回调地址），通过Process.Start打开默认浏览器让用户选择文件。用户选择完成后，Picker会返回文件ID，此时应用即可对该文件执行编辑操作。

重要注意事项 #

• 不要使用服务账号共享邮件的方式：这是后端服务的适配方案，桌面应用基于用户自身OAuth账号，必须通过用户主动授权（Picker）获取文件权限。
• Drive.File权限严格限制应用访问范围，符合Google的权限安全规范，避免过度授权风险。

内容的提问来源于stack exchange，提问作者S.Richmond