调用YouTube Data API v3获取fileDetails未返回fileName问题咨询

调用YouTube Data API v3的/youtube/v3/videos接口获取fileDetails数据时，未能返回fileName字段，但官方文档明确该字段应包含在响应中。以下是通过Google API Explorer测试的请求代码及响应结果：

请求代码 #

curl \
  'https://youtube.googleapis.com/youtube/v3/videos?part=processingDetails%2CfileDetails&id=XCKwoZRXLDo&key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --compressed

响应结果 #

{
  "kind": "youtube#videoListResponse",
  "etag": "rIuY-xUL7uBBAxVGhrxjsbrcwcw",
  "items": [
    {
      "kind": "youtube#video",
      "etag": "m2xLwgh5PUrvxhUOvYYxrBRA5uc",
      "id": "XCKwoZRXLDo",
      "fileDetails": {
        "fileType": "video",
        "container": "mov",
        "videoStreams": [
          {
            "widthPixels": 1280,
            "heightPixels": 720,
            "frameRateFps": 60,
            "aspectRatio": 1.7777777777777777,
            "codec": "h264",
            "bitrateBps": "4411125"
          }
        ],
        "audioStreams": [
          {
            "channelCount": 2,
            "codec": "aac",
            "bitrateBps": "75765"
          }
        ],
        "bitrateBps": "4486890"
      },
      "processingDetails": {
        "processingStatus": "succeeded",
        "fileDetailsAvailability": "available",
        "processingIssuesAvailability": "available",
        "tagSuggestionsAvailability": "inProgress",
        "editorSuggestionsAvailability": "inProgress",
        "thumbnailsAvailability": "available"
      }
    }
  ],
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 1
  }
}

解决办法 #

• 确认视频归属：fileName字段仅对当前授权用户上传的视频可见，若查询的是他人上传的视频，API不会返回该字段。
• 检查授权权限：确保请求使用的AccessToken包含https://www.googleapis.com/auth/youtube或https://www.googleapis.com/auth/youtube.upload权限，只读权限（如youtube.readonly）无法获取该字段。
• 等待数据同步：若视频刚上传完成，后台可能还未完成fileName字段的同步，等待10-30分钟后重试请求。
• 验证API版本：确认调用的是YouTube Data API v3，旧版本接口存在字段缺失的情况。

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