Python调用Google Drive API开发文件展示应用遇授权报错及文件夹遍历问题
报错排查与解决方案
两类报错的核心原因
- 首次授权弹出
Message='client_secret'错误:程序调用OAuth流程加载客户端配置时,检测到credentials.json文件内缺失规定的client_secret字段,触发校验失败。最常见的原因是配置文件类型选错:很多人会把Google Cloud后台下载的服务账号密钥、API密钥文件直接当OAuth客户端配置使用,这类文件结构本身就没有client_secret、client_id字段,自然无法通过校验。 - 重命名配置文件后出现“授权用户信息格式不匹配,缺失client_secret、client_id、refresh_token字段”的报错:重命名后程序找不到合法的OAuth初始凭证,没法走完完整的授权流程生成有效授权信息,项目目录里残留的不完整
token.json被程序误判为有效授权文件。这类空配置里没有接口要求的字段,就会触发格式校验错误。
修复步骤
- 先清空项目根目录下所有残留的无效配置:删掉之前生成的
token.json、类型错误的credentials.json文件,避免旧文件干扰后续校验。 - 在Google Cloud后台重新创建桌面应用类型的OAuth 2.0客户端配置,把下载的json文件准确命名为
credentials.json,和运行的python_consol_app.py脚本放在同一目录下。注意:不要选择Web应用类型的OAuth配置、不要使用服务账号密钥、不要手动编辑json内的字段值,否则依然会触发字段校验报错。
- 重新运行脚本,走完本地浏览器的授权流程,程序会自动生成包含完整
client_id、client_secret、refresh_token字段的合法token.json,后续的授权环节就不会再报同类错误。
关于全层级文件夹遍历的支持说明
- 当前使用的
drive.metadata.readonly只读权限,完全满足遍历所有层级文件、子文件夹的需求。 - Google Drive v3 API的资源模型里,文件和文件夹属于同一类资源:文件夹有固定的MIME类型
application/vnd.google-apps.folder,所有资源的父子关联关系都存在parents字段中,接口设计本身就支持层级遍历。 - 要实现全层级目录遍历,需要在现有示例代码基础上调整接口调用逻辑:
- 首次调用
files.list接口时,添加查询条件筛选所有顶级文件夹(规则:父级指向根目录、类型为文件夹、未放入回收站) - 对每个拿到的顶级文件夹ID,再次调用
files.list接口,筛选当前文件夹直属的所有文件、子文件夹 - 对每一层拿到的子文件夹ID做递归查询,直到遍历完所有层级;调用接口时记得开启分页参数,避免文件夹内文件量较大时出现漏读。
- 首次调用
- 你当前的示例代码只默认拉取根目录下前10条文件记录,没有添加文件夹类型筛选、递归查询的逻辑,所以没法展示完整的全层级目录结构。
内容的提问来源于stack exchange,提问作者Ahmed El-Nagar
相关产品推荐
相关产品推荐

