LinkedIn视频帖创建API调用成功获URN ID，但帖子未展示请求排查

• 视频文件合规性检查
  确认视频参数完全符合LinkedIn要求：格式必须是MP4（H.264视频编码+AAC音频编码），分辨率在240p到4K之间，时长1秒到10分钟，文件大小不超过5GB。同时检查视频元数据是否完整，缺失时长、码率这类关键信息可能导致平台无法解析展示。

• 视频上传全流程验证
  视频帖发布分两步：先通过assets端点上传视频拿到asset URN，再把该URN填入帖子创建请求的content.media字段。必须确保两步都成功，且上传视频的响应里asset状态是AVAILABLE——如果还处于PROCESSING状态就创建帖子，大概率会出现视频不展示的情况。

• 权限与账号设置核查
  核实应用OAuth权限范围是否包含w_member_social（个人账号发帖）或w_organization_social（企业账号发帖），虽然文本/图片帖能用，但要确认授权时没遗漏权限。另外检查发帖账号本身是否有视频发布权限，部分企业账号可能有后台审核限制，需要登录LinkedIn后台确认账号权限设置。

• 帖子请求体结构校验
  对比能正常发布的文本/图片帖请求体，检查视频帖的JSON结构是否正确，重点关注这些字段：

  {
    "author": "urn:li:person:XXX",
    "lifecycleState": "PUBLISHED",
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareCommentary": { "text": "测试视频帖" },
        "shareMediaCategory": "VIDEO",
        "media": [
          {
            "status": "READY",
            "description": { "text": "视频描述" },
            "media": "urn:li:digitalmediaAsset:XXX",
            "title": { "text": "视频标题" }
          }
        ]
      }
    },
    "visibility": { "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC" }
  }
  

  确保shareMediaCategory设为VIDEO，media数组里的asset URN准确，status值为READY。

• LinkedIn后台内容状态排查
  登录发帖账号的LinkedIn后台，查看「已发布内容」或「草稿」页面，确认视频帖是否被系统拦截、处于审核中，或是因内容合规问题被隐藏——这类情况API会返回成功，但平台不会公开展示。同时检查账号是否有违规记录，近期违规可能导致视频帖被限制展示。

• API版本与端点确认
  确认使用的API是最新稳定版（比如v202405），旧版本可能存在视频处理的兼容性问题。另外确保帖子创建端点是https://api.linkedin.com/v2/ugcPosts，不要误用其他端点导致异常。

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