使用YouTube JS API v3获取频道最新4个视频结果不符的问题

我通过YouTube Data API v3的Search接口请求指定频道的最新4个视频，请求URL如下：

https://www.googleapis.com/youtube/v3/search?part=snippet&key=${apiKey}&channelId=${espacioSutilChannelID}&maxResults=4&order=date

但返回的结果并非该频道的最新视频——目标频道视频页显示的最新内容和接口返回的2023年6月的视频完全不匹配，接口返回的JSON数据如下：

{
  "kind": "youtube#searchListResponse",
  "etag": "YLx4MtKRajR1pi0SsHeY_PgBpn8",
  "nextPageToken": "CAQQAA",
  "regionCode": "ES",
  "pageInfo": {
    "totalResults": 1073,
    "resultsPerPage": 4
  },
  "items": [
    {
      "kind": "youtube#searchResult",
      "etag": "ibQqD0y_7TR1b53OUcMtESa2eng",
      "id": {
        "kind": "youtube#video",
        "videoId": "7TMjENsCtWg"
      },
      "snippet": {
        "publishedAt": "2023-06-28T18:50:22Z",
        "channelId": "UCBHahOd3MSYL2ONV17F1XGQ",
        "title": "CONVERSACIONES CON DIOS - Libro I. Capítulo 1 (15ª parte)",
        "description": "Grabaciones de las sesiones de Iván Prospector de explicación de la información revelada en la serie de libros de ...",
        "thumbnails": {
          "default": {
            "url": "https://i.ytimg.com/vi/7TMjENsCtWg/default.jpg",
            "width": 120,
            "height": 90
          },
          "medium": {
            "url": "https://i.ytimg.com/vi/7TMjENsCtWg/mqdefault.jpg",
            "width": 320,
            "height": 180
          },
          "high": {
            "url": "https://i.ytimg.com/vi/7TMjENsCtWg/hqdefault.jpg",
            "width": 480,
            "height": 360
          }
        },
        "channelTitle": "Espacio Sutil",
        "liveBroadcastContent": "none",
        "publishTime": "2023-06-28T18:50:22Z"
      }
    },
    {
      "kind": "youtube#searchResult",
      "etag": "bqcXP8NVeSA7UpaYHPgrJvtZ10E",
      "id": {
        "kind": "youtube#video",
        "videoId": "CTxo_UdAdWc"
      },
      "snippet": {
        "publishedAt": "2023-06-27T20:25:23Z",
        "channelId": "UCBHahOd3MSYL2ONV17F1XGQ",
        "title": "UN CURSO DE MILAGROS - 12.VI - La visión de Cristo (1 a 7 de 7)",
        "description": "Grabaciones de las sesiones de Iván Prospector de la serie de lectura acompañada de Un Curso de Milagros. Se pretende la ...",
        "thumbnails": {
          "default": {
            "url": "https://i.ytimg.com/vi/CTxo_UdAdWc/default.jpg",
            "width": 120,
            "height": 90
          },
          "medium": {
            "url": "https://i.ytimg.com/vi/CTxo_UdAdWc/mqdefault.jpg",
            "width": 320,
            "height": 180
          },
          "high": {
            "url": "https://i.ytimg.com/vi/CTxo_UdAdWc/hqdefault.jpg",
            "width": 480,
            "height": 360
          }
        },
        "channelTitle": "Espacio Sutil",
        "liveBroadcastContent": "none",
        "publishTime": "2023-06-27T20:25:23Z"
      }
    },
    {
      "kind": "youtube#searchResult",
      "etag": "I51wNWmW448hKimAAsuyr1-0ABY",
      "id": {
        "kind": "youtube#video",
        "videoId": "wS9Bw9K6l-8"
      },
      "snippet": {
        "publishedAt": "2023-06-27T20:08:59Z",
        "channelId": "UCBHahOd3MSYL2ONV17F1XGQ",
        "title": "NUESTRAS VOCES - (6ª) - Viajes astrales y sueños lúcidos",
        "description": "Grabaciones del programa de divulgación terapéutica espiritual de Espacio Sutil NUESTRAS VOCES - Jessica Pernett - María ...",
        "thumbnails": {
          "default": {
            "url": "https://i.ytimg.com/vi/wS9Bw9K6l-8/default.jpg",
            "width": 120,
            "height": 90
          },
          "medium": {
            "url": "https://i.ytimg.com/vi/wS9Bw9K6l-8/mqdefault.jpg",
            "width": 320,
            "height": 180
          },
          "high": {
            "url": "https://i.ytimg.com/vi/wS9Bw9K6l-8/hqdefault.jpg",
            "width": 480,
            "height": 360
          }
        },
        "channelTitle": "Espacio Sutil",
        "liveBroadcastContent": "none",
        "publishTime": "2023-06-27T20:08:59Z"
      }
    },
    {
      "kind": "youtube#searchResult",
      "etag": "DQBz6HWuhyX6YBCckhaPLABY6YA",
      "id": {
        "kind": "youtube#video",
        "videoId": "DcnHUhl6ruo"
      },
      "snippet": {
        "publishedAt": "2023-06-27T20:10:30Z",
        "channelId": "UCBHahOd3MSYL2ONV17F1XGQ",
        "title": "UN CURSO DE AMOR - TAP.9 (1) - Dar y recibir (1 a 10 de 16)",
        "description": "Grabaciones de las sesiones de Iván Prospector de explicación de la información revelada por Jesús, a través de Mari Perron y ...",
        "thumbnails": {
          "default": {
            "url": "https://i.ytimg.com/vi/DcnHUhl6ruo/default.jpg",
            "width": 120,
            "height": 90
          },
          "medium": {
            "url": "https://i.ytimg.com/vi/DcnHUhl6ruo/mqdefault.jpg",
            "width": 320,
            "height": 180
          },
          "high": {
            "url": "https://i.ytimg.com/vi/DcnHUhl6ruo/hqdefault.jpg",
            "width": 480,
            "height": 360
          }
        },
        "channelTitle": "Espacio Sutil",
        "liveBroadcastContent": "none",
        "publishTime": "2023-06-27T20:10:30Z"
      }
    }
  ]
}

问题原因 #

• Search接口的固有局限：Search接口的order=date虽按发布时间排序，但结果会受区域限制、API数据索引延迟、隐私视频过滤等因素影响，无法完全同步官网频道页的内容。且默认返回视频、播放列表等多种类型内容，可能干扰排序结果。
• 官网与API排序逻辑差异：YouTube频道视频页的排序会结合用户互动数据、区域个性化推荐调整，和API纯按发布时间排序的逻辑不完全一致，导致显示内容不同。

解决方案 #

要精准获取频道最新视频，推荐使用Channels + PlaylistItems的组合接口，这是官方推荐的标准方案：

步骤1：获取频道的上传播放列表ID #

调用Channels接口，通过频道ID拿到其专属的上传视频列表ID：

https://www.googleapis.com/youtube/v3/channels?part=contentDetails&id=${espacioSutilChannelID}&key=${apiKey}

返回结果里的contentDetails.relatedPlaylists.uploads字段就是目标播放列表ID，该列表包含频道所有公开上传的视频，按发布时间倒序排列。

步骤2：获取最新4个视频 #

用拿到的上传列表ID调用PlaylistItems接口，直接取最新4条：

https://www.googleapis.com/youtube/v3/playlistItems?part=snippet&playlistId=${uploadsPlaylistId}&maxResults=4&key=${apiKey}

这个接口返回的内容完全对应频道的上传历史，不会有Search接口的过滤或排序偏差，能确保拿到真正的最新视频。

临时优化（若坚持用Search接口） #

在原请求里加上&type=video参数，强制只返回视频类型结果，减少非视频内容对排序的干扰：

https://www.googleapis.com/youtube/v3/search?part=snippet&key=${apiKey}&channelId=${espacioSutilChannelID}&maxResults=4&order=date&type=video

但这种方式仍可能存在数据延迟或过滤问题，不如PlaylistItems方案可靠。

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