如何在Vimeo API中使用query_fields与query筛选非公开视频？

• 明确结论：query_fields参数不支持privacy.view这类结构化元数据字段，它仅针对文档默认的全文搜索字段（title、description、chapters、tags）设计，你用它指定privacy.view才会触发2969错误。
• 要筛选未列出（unlisted）的视频，不能用query+query_fields组合，而是要用Vimeo API提供的过滤参数：filter[privacy]。

正确的Python请求示例 #

假设使用requests库，代码如下：

import requests

headers = {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
}

params = {
    'filter[privacy]': 'unlisted',
    # 可选：添加分页、字段选择等其他参数
    'per_page': 20,
}

response = requests.get('https://api.vimeo.com/me/videos', headers=headers, params=params)
print(response.json())

补充说明 #

Vimeo的query参数是用于全文模糊搜索的，只能匹配被索引的全文字段；而隐私设置、创建时间这类结构化属性，都需要用对应的filter参数来筛选。你可以查看Vimeo官方文档中/me/videos/端点的所有可用过滤参数，里面会列出所有支持的结构化筛选条件。

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