Vimeo Pull方式上传视频时名称描述失效、返回非标准ID问题咨询

1. 视频名称、描述参数不生效问题 #

• 根因：参数层级配置错误，你将name、description、隐私配置类参数全部放在了upload对象内部，而Vimeo API规范要求这几类参数属于请求体顶层参数，放在错误层级的参数会被API直接忽略，不会生效。同时你原本用点号拼接的隐私参数写法不符合JSON结构要求，也会导致配置不生效。
• 修复方案：调整参数层级，把名称、描述、隐私配置参数从upload对象中移出，放到请求体的根层级，且隐私参数改为嵌套对象格式。

2. 非标准视频ID无法被第三方应用识别问题 #

• 根因：你看到的字母数字组合后缀（示例中的b99c5d6405）不是视频ID，是私有视频的隐私校验哈希值，链接中的数字部分640201271才是符合官方规范的整数类型视频ID。当视频的可见性设置为nobody等私有级别时，访问链接会自动拼接隐私哈希，避免被未授权用户猜测访问。
• 修复方案：从API返回结果的uri字段（格式为/videos/[整数ID]）中提取数字部分，即可得到标准整数视频ID，可正常被Integromat的Vimeo应用识别。

修正后的请求Payload示例 #

{
  "name": "Alex Sirota's Personal Meeting Room - alex@newpathconsulting.com - 0",
  "description": "Recording Start Date/Time: 2021-10-28 09:55 PM - Recording End Date/Time: 2021-10-28 09:55 PM - Duration (min): 0",
  "privacy": {
    "download": false,
    "embed": "private",
    "view": "nobody"
  },
  "upload": {
    "approach": "pull",
    "size": "784755",
    "link": "https://us02web.zoom.us/rec/download/redacted?access_token=redacted"
  }
}

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