Web应用使用Google Drive API的凭据需求及代码故障排查

一、Web应用管理个人Drive需要的凭据 #

针对你的服务器端Web应用（比如Heroku上的服务）操作个人Drive的场景，主要需要两种凭据中的一种，按需选择：

• 服务账号凭据：这是最适合你的方案，通过JSON密钥文件完成身份验证。要注意的是，服务账号有独立的Drive存储空间，若要访问你的个人Drive内容，必须手动把目标文件/文件夹共享给服务账号对应的邮箱（密钥文件里的client_email字段），否则服务账号没有访问权限。
• OAuth 2.0客户端ID：如果你的应用需要让其他用户授权访问他们的个人Drive，就用这个。但你的场景是管理自己的Drive，服务账号足够用，无需复杂的OAuth登录流程。

二、代码无限停滞的问题排查与修复 #

看了你的代码，有几个明显的问题导致请求异常，我帮你梳理并修复：

1. 冗余的gspread依赖 #

你引入了gspread库并调用了gspread.authorize(creds)，但gspread是专门操作Google Sheets的工具，和Drive API完全无关。这一步不仅多余，还可能干扰凭据的授权流程，直接删掉就行。

2. Drive API v3的参数错误 #

你在files().copy()的请求体里用了'title'字段，但Drive API v3已经把文件名称字段改成了'name'（v2版本才用title），参数不匹配会导致API请求无法正确处理，进而引发停滞。

3. 不必要的parents参数格式 #

parents字段不需要嵌套kind和id的对象，直接传入文件夹ID的数组即可，简化成"parents": [folder_id]就可以正常工作。

4. 权限验证的潜在问题 #

确认你已经把要复制的源文件和目标文件夹都共享给了服务账号的邮箱（从你的CREDENTIALS环境变量对应的JSON里找client_email），如果没有共享，服务账号没有访问权限，请求可能会挂起或者返回权限错误。

修复后的代码 #

我把代码优化了一下，替换了更现代的google-auth库方式，同时修正了所有问题：

import os
import json
from google.oauth2.service_account import Credentials
from googleapiclient.discovery import build

# 定义Drive API的权限范围
scope = ['https://www.googleapis.com/auth/drive']

# 从Heroku环境变量加载服务账号凭据
creds = Credentials.from_service_account_info(
    json.loads(os.environ.get('CREDENTIALS')),
    scopes=scope
)

# 构建Drive API服务实例
service = build('drive', 'v3', credentials=creds, cache_discovery=False)

# 配置目标文件夹和源文件ID
folder_id = "12vQQwYK5bkg-6UKoNrXpsU1C1-fiYeTX"
file_id = "1EA25-BYr1AAUUDcstfVowDeGoygMGuxKxGxFYEdKTX0"
new_file_name = "New_file_id"

# 执行文件复制并捕获异常
try:
    copied_file = service.files().copy(
        fileId=file_id,
        body={
            "parents": [folder_id],
            "name": new_file_name
        }
    ).execute()
    print(f"文件复制成功！新文件ID：{copied_file['id']}")
except Exception as e:
    print(f"复制失败，错误信息：{str(e)}")

额外注意事项 #

• 确保Heroku的CREDENTIALS环境变量是完整的服务账号JSON字符串，没有格式错误（比如引号转义是否正确）。
• 检查Heroku的网络是否能正常访问Google API，一般默认是没问题的，但如果有自定义防火墙规则，要确保放行*.googleapis.com域名。

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