使用Python指定Google Drive文件夹ID获取文件列表返回空如何解决？

问题根因 #

• 查询语句语法错误：代码中的q参数查询条件写反了，不符合Google Drive API的过滤规则
• 缺少共享盘兼容参数：企业环境的文件夹多属于组织共享盘/共享目录，默认API调用不会返回这类资源
• 查询范围配置错误：查询范围默认仅包含当前凭证的个人网盘内容，未覆盖企业共享资源范围
• 服务账号模拟配置错误：如果使用了全域委托的服务账号，未指定要模拟的域内用户账号，服务账号默认访问自身的空网盘，自然返回空列表

解决方案 #

1. 修正查询语法 #

标准父目录过滤语法为 '[目标文件夹ID]' in parents，你当前使用的parents in '[文件夹ID]'是无效语法，个人凭证能返回大概率是测试时临时调整了语法，正式环境用了错误写法。

2. 补充共享盘兼容参数 #

调用files().list()时必须新增两个参数：

• supportsAllDrives=True：告知API支持访问共享盘资源
• includeItemsFromAllDrives=True：返回结果中包含共享盘内匹配的资源

3. 适配查询范围（共享盘场景必填） #

如果目标文件夹存放在企业共享盘内，需补充以下参数：

• corpora='drive'：指定查询范围为指定共享盘
• driveId='[共享盘ID]'：指定要查询的共享盘ID

4. 检查服务账号模拟配置（全域委托场景必填） #

如果你的企业凭证是开启了全域权限委托的服务账号，必须在构造凭证时指定要模拟的域内用户，确保以该用户的身份访问目录资源。 #

修正后的完整代码示例 #

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

# 基础配置
SCOPES = ['https://www.googleapis.com/auth/drive']
SERVICE_ACCOUNT_FILE = '你的企业凭证密钥文件路径.json'
# 替换为你的目标文件夹ID
target_folder_id = "MY FOLDER ID"
# 替换为共享盘ID，非共享盘场景可删除对应参数
target_drive_id = "MY DRIVE ID"
# 替换为有目标文件夹访问权限的域内用户邮箱，无全域委托场景可删除
impersonate_user = 'user@your-company.com'

# 构造凭证
credentials = service_account.Credentials.from_service_account_file(
        SERVICE_ACCOUNT_FILE, scopes=SCOPES)
# 无全域委托场景删除以下行
delegated_credentials = credentials.with_subject(impersonate_user)

# 构造Drive服务
service = build('drive', 'v3', credentials=delegated_credentials)

# 调用文件列表接口
query = f"'{target_folder_id}' in parents"
name_response = service.files().list(
    q=query,
    supportsAllDrives=True,
    includeItemsFromAllDrives=True,
    # 非共享盘场景删除以下两行
    corpora='drive',
    driveId=target_drive_id
).execute()
        
files = name_response.get('files')
nextPageToken = name_response.get('nextPageToken')

为何增删操作可以正常执行？ #

文件新增、删除操作直接指定目标资源ID，API默认支持共享盘资源访问，不受上述查询参数和过滤规则限制，因此可以正常执行。

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