如何通过Google Drive v3 API一次获取多文件夹的文件元数据

当然可以这么做！这种合并查询的方式完全符合Google Drive API的查询规则，能帮你省去多次调用API的麻烦，直接一次性拉取多个子目录下的所有文件元数据，效率提升很多。

具体实现方式 #

核心就是在API的q参数中，用OR连接多个'子目录ID' in parents的条件。这里给你举个实际的代码示例（以Python为例，其他语言逻辑类似）：

from googleapiclient.discovery import build

# 假设你已经完成了API认证，得到了drive service实例
drive_service = build('drive', 'v3', credentials=your_credentials)

# 准备好要查询的所有子目录ID列表
target_parent_ids = ['some-subdir-id-1', 'some-subdir-id-2', 'another-subdir-id']

# 拼接查询字符串：每个ID对应一个条件，用OR连接
query_string = ' OR '.join([f"'{parent_id}' in parents" for parent_id in target_parent_ids])

# 调用files.list API获取数据
response = drive_service.files().list(
    q=query_string,
    fields='files(id, name, mimeType, modifiedTime)',  # 按需指定需要的元数据字段
    pageSize=1000,  # 单次请求最大返回数，最多支持1000条
    supportsAllDrives=True,  # 如果涉及共享驱动器/团队盘，需要开启这个参数
    includeItemsFromAllDrives=True
).execute()

# 处理返回结果
files = response.get('files', [])
if not files:
    print("没有找到匹配的文件")
else:
    for file in files:
        print(f"文件名: {file['name']} | ID: {file['id']} | 类型: {file['mimeType']}")

几个需要注意的点 #

• 查询字符串长度限制：Google Drive API对q参数的长度有上限（大约2048字符），如果你的子目录ID数量特别多，建议分批拼接查询条件，避免触发长度限制报错。
• 分页处理：如果目标文件总数超过pageSize（比如超过1000条），需要通过返回结果中的nextPageToken来循环获取下一页数据，确保不会遗漏文件。
• 权限与参数配置：如果查询的是共享文件夹/团队盘里的内容，一定要记得加上supportsAllDrives=True和includeItemsFromAllDrives=True这两个参数，否则可能无法返回正确的结果。

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