使用Google Drive API删文件遇403 Forbidden错误的排查与解决

我尝试用Google Drive API和Python的requests库删除Google Drive中的文件，但遇到了403 Forbidden错误。

我的代码 #

import requests

headers = {
    "Authorization": GCP_ACCESS_TOKEN,
    "Content-Type": "application/json"
}

file_id = "12345"
params = {
    "supportsAllDrives": True
}

response = requests.delete(
    f"https://www.googleapis.com/drive/v3/files/{file_id}",
    headers=headers,
    params=params
)
print(response.json())

错误信息 #

Exception: 403 Client Error: Forbidden for URL: https://www.googleapis.com/drive/v3/files/12345?supportAllDrives=True

已配置的OAuth权限范围 #

包含以下权限：

• 非敏感范围：
  • .../auth/drive.file：查看、编辑、创建和删除与本应用关联的特定Google Drive文件
  • .../auth/drive.appdata：查看、创建和删除Google Drive中自身的配置数据
• 敏感范围：
  • .../auth/docs：查看、编辑、创建和删除所有Google Drive文件

文件属性 #

{
    "kind": "drive#fileList",
    "incompleteSearch": "False",
    "files": [
        {
            "kind": "drive#file",
            "fileExtension": "pdf",
            "capabilities": {
                "canDelete": "False",
                "canChangeViewersCanCopyContent": "False",
                "canRemoveChildren": "False",
                "canRemoveContentRestriction": "False",
                "canDeleteChildren": "False"
            }
        }
    ]
}

从文件属性可见，canDelete字段为False。

问题 #

为何删除该文件时会出现403 Forbidden错误？如何解决才能通过Google Drive API成功删除文件？

更新1 #

感谢Linda的建议。我调用files.get()接口得到了有效JSON响应：

{
    "kind": "drive#file",
    "id": "12345",
    "name": "sample_file.pdf",
    "teamDriveId": "TEST"
}

我使用OAuth 2.0客户端通过端点https://www.googleapis.com/upload/drive/v3/files上传文件，遵循Google Drive API上传管理文档。

基于已配置的权限范围，且我能获取文件元数据，我认为应该可以删除该文件。请问为何删除时仍会遇到403 Forbidden错误？

解答 #

错误原因 #

1. 文件自身权限限制：文件属性里的canDelete: False直接说明当前授权账号没有该文件的删除权限，这是核心问题——API权限范围只是基础，文件层面的共享/权限设置会直接限制操作。
2. Team Drive角色限制：文件属于Team Drive（返回结果里有teamDriveId），这类文件的删除权限由Team Drive的成员角色决定：只有管理员或内容管理者才有删除权限，查看者、评论者甚至部分编辑者都无法删除。
3. 权限范围不匹配：
   • .../auth/drive.file仅能删除由你的应用创建、且所有权未转移的文件；如果文件所有权已转到Team Drive或其他账号，这个权限无效。
   • .../auth/docs权限仅针对Google Docs类文件（文档、表格、幻灯片等），你要删除的是PDF，这个权限对非Docs类文件不生效。
4. 请求参数拼写错误：错误信息里显示参数是supportAllDrives（少了一个s），而API要求的正确参数名是supportsAllDrives，拼写错误可能导致请求未正确识别Team Drive操作权限。

解决方法 #

1. 调整Team Drive角色：登录Google Drive网页版，进入对应的Team Drive，确认当前账号的角色是管理员或内容管理者；如果不是，联系Team Drive拥有者调整角色。
2. 更换合适的API权限范围：
   • 把.../auth/docs替换为.../auth/drive（全权限，需Google审核）或.../auth/drive.modify（修改所有文件权限），这两个权限适用于所有类型的Drive文件，包括Team Drive中的文件。
   • 注意：敏感权限范围需要在Google Cloud控制台提交审核，审核通过后才能正常使用。
3. 修正请求参数：确保参数名是supportsAllDrives=True，避免拼写错误。
4. 确认文件所有权：如果文件是你的应用上传，但所有权已转移，需要由Team Drive管理员操作，或者确保应用拥有Team Drive的操作权限。

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