如何通过YouTube API将Shorts关联至原始视频？

要实现和YouTube Studio手动操作一致的「关联Shorts至原始视频」效果，需使用YouTube Data API v3的对应接口，以下是具体实现方式：

前提准备 #

• 已在Google Cloud Console启用YouTube Data API v3，并获取了具备对应权限的OAuth 2.0凭据（权限需包含https://www.googleapis.com/auth/youtube或https://www.googleapis.com/auth/youtube.upload）。
• 要关联的Shorts和原始视频必须属于同一YouTube频道。

场景一：上传Shorts时直接关联原始视频 #

使用videos.insert接口上传Shorts的同时，在元数据中指定原始视频ID，即可完成关联：

1. 构造请求元数据（JSON格式），将recordingDetails.referenceVideoId设为原始视频的YouTube ID：

{
  "snippet": {
    "title": "你的Shorts标题",
    "description": "关联至原始视频的衍生Shorts",
    "categoryId": "22"
  },
  "recordingDetails": {
    "referenceVideoId": "原始视频的ID（如abc123）"
  },
  "status": {
    "privacyStatus": "public"
  }
}

2. 通过multipart/form-data格式发送请求，同时上传符合竖屏比例、时长≤60秒规范的Shorts视频文件。

场景二：更新已上传的Shorts关联原始视频 #

如果Shorts已完成上传，可使用videos.update接口补关联：

1. 构造更新请求的元数据，指定目标Shorts的ID和要关联的原始视频ID：

{
  "id": "已上传的Shorts视频ID",
  "recordingDetails": {
    "referenceVideoId": "原始视频的ID"
  }
}

2. 调用接口时需指定part=recordingDetails参数，明确只更新关联信息字段。

注意事项 #

• 若需取消关联，可再次调用videos.update将referenceVideoId设为空字符串。
• 确保OAuth令牌对应的账号拥有目标频道的管理权限，否则会返回权限错误。

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