如何通过LinkedIn API获取企业主页原生视频？求相关文档指引

嘿，这个问题问得好——LinkedIn API确实支持获取企业主页的原生视频动态，只是需要注意正确的接口调用方式和权限配置，下面给你详细的操作指引：

1. 确认使用的API端点与必要权限 #

你需要用到「企业主页动态流API」（Organization Feed API），并且你的开发者应用必须申请到以下核心权限：

• r_organization_social：读取企业主页社交内容的关键权限，这个权限属于受限权限，需要在LinkedIn开发者平台提交应用用途说明，通过审核后才能获取。
• 该权限默认包含读取媒体内容的权限，无需额外申请其他媒体权限，但要确保权限状态是「已批准」。

2. 请求时指定视频相关的返回字段 #

LinkedIn API默认不会返回所有字段，所以你需要在请求中显式指定要拉取媒体内容的字段。举个GET请求的例子：

GET /v2/organizationalEntityFeeds?q=organizationalEntity&organizationalEntity=urn:li:organization:{你的企业ID}&projection=(elements*(actor,object(content,media)))

这里的核心是projection参数里的object(media)，它会让接口返回动态关联的所有媒体内容，原生视频会被归类在media数组中。

3. 解析响应中的原生视频数据 #

当你拿到接口响应后，找到elements数组里的动态条目，进入object.media数组，其中type为VIDEO的就是原生视频。你可以从中提取这些关键信息：

• originalUrl：视频的原始播放地址（注意：部分场景下可能需要确保权限足够才能拿到可直接播放的链接）
• duration：视频的总时长
• height/width：视频的分辨率参数
• thumbnail：视频的缩略图地址和尺寸信息

4. 常见问题排查 #

如果按照上面的步骤还是拿不到原生视频，可以检查这几点：

• 确认你的企业主页确实存在原生视频动态（先手动在LinkedIn网页端验证）
• 检查开发者应用的r_organization_social权限是否已经通过审核并生效
• 核对请求的projection参数是否正确，有没有遗漏media字段的嵌套
• 区分原生视频和第三方嵌入视频：原生视频是直接上传到LinkedIn的，类型为VIDEO；而嵌入的YouTube等视频会被标记为ARTICLE或其他类型，不属于原生视频范畴

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