GoogleDriveAPI上传教程：服务账户文件夹使用指南

在使用Google Drive API通过服务账户上传文件时，文件未出现在预期文件夹？本文提供详细的解决方案，助你轻松解决此问题。核心在于理解服务账户拥有独立的Google Drive空间，需将目标文件夹共享给服务账户，并在上传请求中明确指定该文件夹ID作为`parents`属性。本文将详细介绍如何获取服务账户邮箱地址、共享Google Drive文件夹、获取目标文件夹ID，并提供修改后的Python代码示例，指导你正确配置认证信息、指定上传文件夹，确保文件准确无误地上传到你预期的Google Drive文件夹中。通过本文，你将掌握使用Google Drive API服务账户上传文件的关键步骤和注意事项，提升开发效率。

本文旨在解决使用Google Drive API通过服务账户上传文件时，文件未显示在预期文件夹的问题。核心解决方案在于理解服务账户拥有独立的Google Drive空间，并需通过将目标文件夹共享给服务账户，然后在文件上传请求中明确指定该文件夹ID作为`parents`属性，以确保文件正确上传至指定位置。

理解服务账户与Google Drive文件关联

在使用Google Drive API进行文件操作时，尤其是通过服务账户进行认证，一个常见的误解是服务账户上传的文件会自动出现在个人Google Drive的某个指定位置。实际上，每个服务账户都拥有其独立的Google Drive空间。当您不指定文件上传的目标文件夹时，文件会被上传到该服务账户自身的根目录中，而不是您的个人Google Drive。因此，即使API调用成功，您也无法在个人Google Drive中看到这些文件。

要解决这个问题，关键在于明确告知Google Drive API将文件上传到哪个特定文件夹。这涉及到两个核心步骤：将目标文件夹共享给服务账户，以及在上传请求中正确使用parents字段。

步骤一：将目标文件夹共享给服务账户

由于服务账户是一个独立的实体，它需要被授权访问您的个人Google Drive中的特定资源。要让服务账户能够将文件上传到您个人Drive中的某个文件夹，您必须将该文件夹共享给服务账户的电子邮件地址。

1. 获取服务账户电子邮件地址：

   • 登录Google Cloud Console。
   • 导航到“IAM & Admin” > “Service accounts”。
   • 找到您正在使用的服务账户，并复制其电子邮件地址（通常格式为your-service-account-name@project-id.iam.gserviceaccount.com）。

2. 共享Google Drive文件夹：

   • 打开您的Google Drive（drive.google.com）。
   • 找到您希望上传文件的目标文件夹。
   • 右键点击该文件夹，选择“共享”或“Share”。
   • 在共享对话框中，粘贴您复制的服务账户电子邮件地址。
   • 确保服务账户拥有“编辑者”或“组织者”权限，以便它能够上传文件。
   • 点击“发送”或“Share”完成共享。

步骤二：获取目标文件夹ID

在API请求中，您需要提供目标文件夹的唯一标识符，即文件夹ID。

1. 获取文件夹ID：
   • 在Google Drive中，打开您刚刚共享的目标文件夹。
   • 查看浏览器地址栏，URL通常会是https://drive.google.com/drive/folders/YOUR_FOLDER_ID。
   • 复制folders/后面的字符串，这就是您的目标文件夹ID。

步骤三：修改Python代码以指定上传文件夹

现在，您需要更新Python代码，将获取到的文件夹ID应用到文件上传请求中。

以下是修正后的示例代码，它演示了如何使用parents字段来指定文件上传的目标文件夹：

from __future__ import print_function
import os

from google.oauth2 import service_account
from googleapiclient.discovery import build
from googleapiclient.http import MediaFileUpload

# 1. 配置认证信息
# 定义API作用域，这里我们只需要文件操作权限
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
)

# 构建Google Drive API服务客户端
drive_service = build('drive', 'v3', credentials=credentials)

# 2. 指定目标文件夹ID
# 替换为您的Google Drive中共享给服务账户的文件夹ID
# 务必确保此ID对应的是您希望上传文件的文件夹
target_folder_id = '1MAM4CPDMbqpzP5rZb1Zw0A15r4U7B4Kv' # 示例ID，请替换为实际ID

# 3. 定义文件元数据，并包含'parents'字段
file_metadata = {
    'name': 'test_file.txt', # 上传后在Google Drive中显示的文件名
    'parents': [target_folder_id] # 关键：指定文件上传的目标文件夹ID
}

# 4. 准备要上传的媒体文件
# 替换为本地要上传的文件路径和对应的MIME类型
local_file_path = 'C:\\Users\\danie\\OneDrive\\Documentos\\PAP\\testeicheiro\\Ficheiro_teste.txt'
media = MediaFileUpload(local_file_path, mimetype='text/plain')

# 5. 执行文件上传操作
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}")

代码解析与注意事项：

• SERVICE_ACCOUNT_FILE: 确保这是您的服务账户密钥文件的正确路径。
• target_folder_id: 这是最重要的部分。请务必将其替换为您在步骤二中获取到的目标文件夹ID。
• file_metadata['parents']: 这是一个列表，即使只有一个父文件夹，也需要将其作为列表元素传入。
• fields='id, name, parents': 在create方法中指定fields参数可以获取上传后文件的更多信息，例如其ID、名称以及它所属的父文件夹ID，这有助于验证上传是否成功且位置正确。
• 错误处理: 建议在实际项目中加入更完善的错误处理机制，例如使用try...except块来捕获API调用可能产生的异常。

总结

通过服务账户使用Google Drive API上传文件至指定文件夹，核心在于理解服务账户的独立性，并通过明确的权限共享和parents字段指定目标。首先，将您个人Drive中的目标文件夹共享给服务账户的电子邮件地址；其次，获取该目标文件夹的ID；最后，在您的Python代码中，通过file_metadata字典的parents键，将该文件夹ID作为值传递给files().create()方法。遵循这些步骤，即可确保文件准确无误地上传到您预期的Google Drive文件夹中。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《GoogleDriveAPI上传教程：服务账户文件夹使用指南》文章吧，也可关注golang学习网公众号了解相关技术文章。