获取频道“视频”小节中列出的 youtube 视频

Question

如何在频道的“视频”标签的下拉菜单项中列出视频？

它是带有 ID 的播放列表吗？如果我想获取所有上传的视频，我可以先查询播放列表'uploads'的id（这里是频道UCj7IJ427cnavyq2ZOpSKYfA）：

GET https://youtube.googleapis.com/youtube/v3/channels?part=contentDetails&id=UCj7IJ427cnavyq2ZOpSKYfA&key=[YOUR_API_KEY] HTTP/1.1

{
  "kind": "youtube#channelListResponse",
  ...,
  "items": [
    {
      "kind": "youtube#channel",
      ...,
      "contentDetails": {
        "relatedPlaylists": {
          "likes": "",
          "favorites": "",
          "uploads": "UUj7IJ427cnavyq2ZOpSKYfA" # <- here it is!
        }
      }
    }
  ]
}

并使用它来运行playlistItems。但是只有“即将到来的直播”部分呢？

Answer 1

您应该使用Search.list API 端点，并通过相应设置的请求参数channelId、type 和eventType 调用：

GET https://www.googleapis.com/youtube/v3/search?key=${API_KEY}&type=video&eventType=upcoming&part=snippet&maxResults=50&channelId=${CHANNEL_ID},

${CHANNEL_ID} 是您感兴趣的频道的 ID，${API_KEY} 是您的 API 密钥。

对于您上面提到的频道（ID 为 UCj7IJ427cnavyq2ZOpSKYfA），JSON 响应如下所示：

{
  "kind": "youtube#searchListResponse",
  "etag": "...",
  "regionCode": "...",
  "pageInfo": {
    "totalResults": 4,
    "resultsPerPage": 4
  },
  "items": [
    {
      "kind": "youtube#searchResult",
      "etag": "quPJtDE4C_PAgFJU9QIjA5d_C4k",
      "id": {
        "kind": "youtube#video",
        "videoId": "JksecRTzbgo"
      },
      "snippet": {
        "publishedAt": "2021-05-19T10:33:39Z",
        "channelId": "UCj7IJ427cnavyq2ZOpSKYfA",
        "title": "LIVE: Т. Владимиров, фортепиано. Бах, Рахманинов, Шуберт",
        "description": "Тимофей ВЛАДИМИРОВ, фортепиано В программе: И.С. Бах. Шестиголосный ричеркар из цикла «Музыкальное приношение» Рамо – Годовский.",
        "thumbnails": {
           ...
        },
        "channelTitle": "MOSCOW INTERNATIONAL PERFORMING ARTS CENTER",
        "liveBroadcastContent": "upcoming",
        "publishTime": "2021-05-19T10:33:39Z"
      }
    },
    {
      "kind": "youtube#searchResult",
      "etag": "7LTWdzCS0NDFayU3zbfDcb3xky4",
      "id": {
        "kind": "youtube#video",
        "videoId": "G85Prxi4Mr0"
      },
      "snippet": {
        "publishedAt": "2021-05-25T12:28:10Z",
        "channelId": "UCj7IJ427cnavyq2ZOpSKYfA",
        "title": "LIVE: Лауреаты IV Конкурса пианистов В. Крайнева в возрастной категории от 16 до 22 лет",
        "description": "В День защиты детей Концерт победителей и лауреатов IV Международного конкурса пианистов Владимира Крайнева в возрастной категории от 16 ...",
        "thumbnails": {
           ...
        },
        "channelTitle": "MOSCOW INTERNATIONAL PERFORMING ARTS CENTER",
        "liveBroadcastContent": "upcoming",
        "publishTime": "2021-05-25T12:28:10Z"
      }
    },
    {
      "kind": "youtube#searchResult",
      "etag": "I4FOz2ykBQviPr_7vdF87240iG8",
      "id": {
        "kind": "youtube#video",
        "videoId": "tKDEjh37BrA"
      },
      "snippet": {
        "publishedAt": "2021-05-25T12:01:48Z",
        "channelId": "UCj7IJ427cnavyq2ZOpSKYfA",
        "title": "LIVE: Лауреаты IV Конкурса пианистов В. Крайнева в возрастной категории от 7 до 12 лет",
        "description": "В День защиты детей Концерт победителей и лауреатов IV Международного конкурса пианистов Владимира Крайнева в возрастной категории от 7 до ...",
        "thumbnails": {
           ...
        },
        "channelTitle": "MOSCOW INTERNATIONAL PERFORMING ARTS CENTER",
        "liveBroadcastContent": "upcoming",
        "publishTime": "2021-05-25T12:01:48Z"
      }
    },
    {
      "kind": "youtube#searchResult",
      "etag": "tpF_wpRF43W6fv1MGpNnCBSvCDU",
      "id": {
        "kind": "youtube#video",
        "videoId": "R9Em6BJW0e0"
      },
      "snippet": {
        "publishedAt": "2021-05-25T12:08:55Z",
        "channelId": "UCj7IJ427cnavyq2ZOpSKYfA",
        "title": "LIVE: Лауреаты IV Конкурса пианистов В. Крайнева в возрастной категории от 13 до 15 лет",
        "description": "В День защиты детей Концерт победителей и лауреатов IV Международного конкурса пианистов Владимира Крайнева в возрастной категории от 13 ...",
        "thumbnails": {
           ...
        },
        "channelTitle": "MOSCOW INTERNATIONAL PERFORMING ARTS CENTER",
        "liveBroadcastContent": "upcoming",
        "publishTime": "2021-05-25T12:08:55Z"
      }
    }
  ]
}

请注意，Search.list 端点相对昂贵：每次调用它都会花费您 100 单位的配额（从您的每日配额中计算，默认为 10000 单位）。