C# Google Drive API上传文件 C#如何将文件上传到谷歌云盘

来源：这里教程网时间：2026-02-21 17:42:13 作者：

Google Drive API v3 的认证必须用 OAuth 2.0，服务账号行不通

Google Drive API 不允许服务账号（Service Account）直接写入普通用户网盘——哪怕你用

Subject

模拟用户，也必须确保该用户已显式授权服务账号访问其

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

或更宽权限。本地开发最稳妥的方式是用 OAuth 2.0 用户凭据：调用

GoogleWebAuthorizationBroker.AuthorizeAsync

启动本地浏览器授权流程，首次运行会生成

token.json

缓存凭据。

容易踩的坑：

忘记在 Google Cloud Console 中为项目启用 Drive API（不止是创建凭据） OAuth 凭据类型选成“服务账号密钥”或“API 密钥”，必须选“桌面应用”或“其他” 未将
redirect_uri
设为
urn:ietf:wg:oauth:2.0:oob
或
http://localhost
（取决于客户端库版本）作用域写错，例如用了
drive.readonly
却想上传，应至少用
https://www.googleapis.com/auth/drive.file

上传文件需区分简单上传和分块上传

小文件（Files.Create +

MediaUpload

），大文件必须用分块上传（

Files.Create

with

ResumableUpload

）。C# 客户端库会自动选择，但你要主动控制

FileSize

和

SupportedUploadKinds

行为。

关键实操点：

构造
Google.Apis.Drive.v3.Data.File
对象时，
Parents
字段传
new List<string> { "folder_id" }</string>
才能指定目标文件夹；留空则上传到根目录设置
Body
后，必须调用
FilesResource.CreateRequest.UploadAsync()
（不是
ExecuteAsync
）上传前检查
FileMetaData.MimeType
，如不确定可调用
MimeMapping.GetMimeMapping("file.ext")
（需引用
System.Web
）上传流必须是可重读的（
stream.CanSeek == true
），否则分块上传会失败；临时用
new MemoryStream(File.ReadAllBytes(path))
最保险

上传后获取文件 ID 和分享链接要分两步

Files.Create

返回的

Google.Apis.Drive.v3.Data.File

对象只含基础字段（

Id

Name

WebViewLink

等），但

WebViewLink

默认不可公开访问。若需外链，必须额外调用

Permissions.Create

。

常见错误场景：

直接打印
file.WebViewLink
，结果打开提示“您无权访问此内容”——因为权限未开放调用
Permissions.Create
时传了
type: "user"
却没填
emailAddress
，应改用
type: "anyone"
+
role: "reader"
误以为
file.Id
是短链接，实际它是长字符串 ID（如
1aBcDeFgHiJkLmNoPqRsTuVwXyZ
），拼接
https://drive.google.com/file/d/{id}/view
才是标准链接

调试 403/404 错误优先查 scopes 和 folder ID 权限

上传失败时，

GoogleApiException.Error.Code

为 403 多半是权限问题；404 则大概率是目标文件夹 ID 不存在或当前用户无访问权（哪怕文件夹是自己创建的，也要确认是否被移入“共享云端硬盘”且你有编辑权限）。

快速定位建议：

用
Files.List
+
Q = "'folder_id' in parents"
测试能否列出该文件夹下的内容捕获异常后打印
e.Error.Message
和
e.Error.Errors[0].Reason
，常见值如
insufficientPermissions
、
notFound
、
appNotAuthorized
确认 OAuth token 缓存（
token.json
）未过期，且刷新逻辑已正确配置（
GoogleWebAuthorizationBroker.AuthorizeAsync
内部会处理）如果上传到“共享云端硬盘”（Shared Drive），必须改用
supportsAllDrives = true
并用
corpora = "allDrives"
查询

真正麻烦的是权限继承和共享云端硬盘的混合场景——比如文件夹在共享云端硬盘里，但你的 OAuth 账号只是成员而非管理员，这时即使 ID 正确，上传也会静默失败或返回 404。这种 case 得先用