本文旨在解决使用 google drive api 通过服务账户上传文件时，文件未显示在预期个人云盘中的常见问题。核心在于理解服务账户拥有独立的 drive 空间，而非直接访问个人云盘。解决方案涉及将个人云盘中的目标文件夹共享给服务账户，并正确配置 parents 字段，从而实现文件精准上传至指定位置。
在使用 Google Drive API 进行文件操作，尤其是通过服务账户进行上传时，开发者常会遇到一个困惑：代码执行成功，但文件却未出现在预期的个人 Google Drive 文件夹中。这通常并非代码逻辑错误，而是对 Google Drive 服务账户工作原理的误解所致。本教程将深入探讨这一问题，并提供清晰的解决方案。
理解 Google Drive 服务账户的工作原理
Google Drive API 中的服务账户（Service Account）是一种特殊的账户类型，它代表应用程序而非最终用户进行操作。每个服务账户都拥有一个独立的 Google Drive 空间，这个空间与您的个人 Google Drive 账户是完全隔离的。当您使用服务账户上传文件时，如果未指定目标文件夹，文件默认会被上传到该服务账户自己的 Drive 根目录中，而不是您的个人 Drive 根目录。
这就是为什么即使上传操作看似成功，您也无法在个人 Drive 中找到文件——它们实际上存在于服务账户的 Drive 空间中。
解决方案：共享文件夹与正确配置 parents 字段
要将文件上传到您的个人 Google Drive 中的特定文件夹，您需要执行以下两个关键步骤：
- 将目标文件夹共享给服务账户： 由于服务账户无法直接访问您的个人 Drive，您必须明确地将您希望上传文件的目标文件夹共享给服务账户。
- 在上传请求中指定 parents 字段： 在文件元数据中，使用 parents 字段指定目标文件夹的 ID。
步骤一：获取服务账户的电子邮件地址并共享文件夹
-
获取服务账户电子邮件地址：
- 登录 Google Cloud Console。
- 导航到 "IAM 与管理" -> "服务帐号"。
- 找到您正在使用的服务账户，其下方会显示一个电子邮件地址（通常格式为 [服务账户名称]@[项目ID].iam.gserviceaccount.com）。复制此电子邮件地址。
-
共享 Google Drive 文件夹：
- 在您的个人 Google Drive 中，找到您希望上传文件的目标文件夹。
- 右键点击该文件夹，选择 "共享" 或 "获取链接"。
- 在共享设置中，将之前复制的服务账户电子邮件地址添加为协作者，并赋予其 "编辑者" 权限（至少需要 "编辑者" 权限才能上传文件）。
步骤二：获取目标文件夹 ID
- 在您的个人 Google Drive 中，打开您已共享给服务账户的目标文件夹。
- 查看浏览器地址栏，URL 结构通常为 https://drive.google.com/drive/folders/[文件夹ID]。复制 [文件夹ID] 部分。
步骤三：修改代码以包含 parents 字段
获取了服务账户邮箱和目标文件夹 ID 后，您就可以修改 Python 代码了。关键在于在 file_metadata 中添加 parents 字段，并将其值设置为一个包含目标文件夹 ID 的列表。
以下是修正后的示例代码：
from __future__ import print_function
import os
from google.oauth2 import service_account
from googleapiclient.discovery import build
from googleapiclient.http import MediaFileUpload
# 配置认证信息
SCOPES = ['https://www.googleapis.com/auth/drive.file']
# 请替换为您的服务账户密钥文件路径
SERVICE_ACCOUNT_FILE = 'C:\\Users\\danie\\OneDrive\\Documentos\\PAP\\teste drive\\iris-face-models-565de449aa27.json'
# 创建凭据对象
credentials = service_account.Credentials.from_service_account_file(
SERVICE_ACCOUNT_FILE, scopes=SCOPES
)
# 构建 Drive API 服务
drive_service = build('drive', 'v3', credentials=credentials)
# 请替换为您的目标文件夹ID
# 这个文件夹必须已经共享给上述服务账户的邮箱地址
target_folder_id = '1MAM4CPDMbqpzP5rZb1Zw0A15r4U7B4Kv'
# 定义文件元数据
file_metadata = {
'name': 'test_file.txt',
'parents': [target_folder_id] # 关键：指定目标文件夹ID
}
# 准备要上传的本地文件
# 请替换为您的本地文件路径
local_file_path = 'C:\\Users\\danie\\OneDrive\\Documentos\\PAP\\testeicheiro\\Ficheiro_teste.txt'
media = MediaFileUpload(local_file_path, mimetype='text/plain')
# 执行文件上传
try:
file = drive_service.files().create(
body=file_metadata,
media_body=media,
fields='id,name,parents' # 请求返回文件ID、名称和父文件夹信息，以便验证
).execute()
print(f"文件 '{file.get('name')}' (ID: {file.get('id')}) 已成功上传。")
if file.get('parents'):
print(f"上传至文件夹 ID: {file.get('parents')[0]}")
else:
print("文件上传至服务账户的根目录。")
except Exception as e:
print(f"文件上传失败: {e}")
注意事项与最佳实践
- 权限（SCOPES）： 确保您的 SCOPES 包含必要的权限。https://www.googleapis.com/auth/drive.file 允许应用程序创建和管理其通过 API 访问的文件。如果您需要更广泛的访问权限（例如，访问服务账户 Drive 中的所有文件），可能需要 https://www.googleapis.com/auth/drive，但这通常不推荐，除非绝对必要。
- 服务账户密钥文件安全： SERVICE_ACCOUNT_FILE 包含敏感信息，应妥善保管，切勿将其直接提交到公共代码仓库。在生产环境中，建议使用环境变量或密钥管理服务来存储和访问凭据。
- 错误处理： 在实际项目中，应添加更健壮的错误处理机制，例如 try-except 块来捕获 API 调用可能引发的异常。
- 文件 MIME 类型： MediaFileUpload 中的 mimetype 参数应与您上传的文件类型相匹配。例如，文本文件为 text/plain，JPEG 图片为 image/jpeg。
- 替代方案： 虽然 Google Drive API 是强大的文件存储解决方案，但如果您的项目对云存储有其他特定需求（例如，需要更简单的集成、更低的成本或特定的数据处理功能），也可以考虑其他云存储服务，如 Amazon S3 或 Azure Blob Storage。然而，对于与 Google 生态系统紧密集成的应用，Google Drive API 仍是首选。
总结
通过理解 Google Drive 服务账户的隔离性，并采取将目标文件夹共享给服务账户、以及在代码中正确配置 parents 字段的策略，您可以成功地将文件上传到个人 Google Drive 中的指定位置。这一解决方案不仅解决了文件“消失”的困境，也加深了对 Google Drive API 认证和权限机制的理解，为构建更健壮的云存储集成应用奠定了基础。
