如何使用G Suite服务账户按邮箱上传文件至用户个人Google Drive

刚好在公司里落地过这个多用户Drive上传的场景，用G Suite服务账户配合域范围委派就能完美解决，给你一步步拆解：

一、先搞定域范围委派配置（核心前提） #

要让服务账户能模拟公司内的Google账户操作，必须先在Google Admin控制台开启域范围委派：

• 登录公司的Google Admin控制台，依次进入「安全」>「API控制」>「域范围委派」
• 点击「添加新的客户端ID」，输入你的G Suite服务账户对应的客户端ID（可以从服务账户的凭据JSON文件里找到client_id字段）
• 输入需要授权的API范围，遵循最小权限原则：
  • 如果只是上传文件且让用户能访问，用 https://www.googleapis.com/auth/drive.file 就足够
  • 若需要访问用户Drive内的所有文件，才用 https://www.googleapis.com/auth/drive（不推荐）
• 保存配置后，等待10-15分钟让权限生效（别着急马上测试，谷歌的权限同步需要时间）

二、代码实现模拟用户上传（以Python为例） #

这里用Google官方的Python SDK来实现，其他语言逻辑类似：

1. 安装依赖 #

pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib

2. 核心代码示例 #

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

# 替换成你的服务账户凭据文件路径
SERVICE_ACCOUNT_KEY_PATH = 'your-service-account-key.json'
# Drive API授权范围（和Admin控制台配置的保持一致）
DRIVE_SCOPES = ['https://www.googleapis.com/auth/drive.file']

def upload_to_user_drive(target_user_email, local_file_path, drive_file_name):
    # 生成模拟目标用户的凭据：关键是`subject`参数指定用户邮箱
    credentials = service_account.Credentials.from_service_account_file(
        SERVICE_ACCOUNT_KEY_PATH,
        scopes=DRIVE_SCOPES,
        subject=target_user_email
    )
    
    # 构建Drive服务客户端
    drive_service = build('drive', 'v3', credentials=credentials)
    
    # 配置文件元数据：可以指定上传到用户的某个文件夹（需提前获取文件夹ID）
    file_metadata = {
        'name': drive_file_name,
        # 可选：上传到指定文件夹，把下面的注释去掉并替换成文件夹ID
        # 'parents': ['user-specific-folder-id']
    }
    
    # 准备要上传的文件
    media = MediaFileUpload(local_file_path, resumable=True)
    
    # 执行上传
    uploaded_file = drive_service.files().create(
        body=file_metadata,
        media_body=media,
        fields='id'
    ).execute()
    
    print(f"文件已成功上传到 {target_user_email} 的Drive，文件ID: {uploaded_file['id']}")

# 调用示例：上传给公司内的某个用户
upload_to_user_drive(
    target_user_email='mary@yourcompany.com',
    local_file_path='/local/reports/Q3_sales.pdf',
    drive_file_name='Q3_销售报告.pdf'
)

三、关键注意事项 #

• subject参数是核心：这个参数让服务账户以目标用户的身份执行操作，只有开启了域范围委派才能使用，没有的话会直接报错
• 权限控制：尽量用最小权限，drive.file权限下，用户只能看到你上传的文件，不会访问到他们Drive里的其他内容，更安全
• 文件夹上传：如果要上传到用户的特定文件夹，要么让用户把文件夹分享给服务账户（给编辑权限），要么模拟用户调用Drive API获取其文件夹ID
• 错误排查：如果刚配置完就报错，先检查Admin控制台的权限范围是否正确，再等10分钟左右重试，谷歌的权限同步有时候会慢

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