调用YouTube Player API获取服务器URL偶发错误，刷新后恢复

我用以下PHP代码调用YouTube Player API获取视频源URL：

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.youtube.com/youtubei/v1/player?key=AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
  "videoId": "'.$yt_video_id.'",
  "context": {
    "client": {
      "clientName": "ANDROID",
      "clientVersion": "16.20.35"
    },
    "device": {
      "platform": "ANDROID",
      "platformVersion": "11"
    }
  },
  "playbackMode": "EMBEDDED",
  "playerParams": {
    "autoplay": 1
  }
}');
curl_setopt($ch, CURLOPT_ENCODING, 'gzip, deflate');

$headers = array();
$headers[] = 'Content-Type: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
echo '<pre>';print_r($result); 

正常情况下，接口会返回视频信息、格式及自适应格式，返回的源URL包含expire字段，代表URL会在指定时间后过期。我已经添加逻辑将过期时间存入数据库，当当前时间超过过期时间时重新调用接口获取新URL。

但现在的问题是，这个curl请求偶尔会返回如下错误，刷新后又能正常工作：

"reason": {
  "runs": [{
    "text": "The following content is not available on this app."
  }]
}

我担心这个问题会影响直播视频播放，导致用户无法观看。

请问：

1. 我哪里操作有误？
2. 处理URL过期的最佳方式是什么？
3. 我遗漏了哪些要点？
4. 为什么很多其他视频播放器都能正常工作？

更新：如果把client设置为"WEB"，每次请求都能正常工作。

1. 操作有误的地方 #

你设置的clientName为ANDROID且版本过低（16.20.35是较旧的版本），YouTube的API会对旧客户端版本或非WEB端客户端做限制，部分版权受限、区域限制的视频会触发「该内容在此应用不可用」的错误。而且移动端客户端的校验逻辑更严格，容易出现请求被拦截的情况。

2. 处理URL过期的最佳方式 #

• 优化缓存策略：不要只存储过期时间，还要缓存完整的API返回结果（包括所有格式的URL），当某个URL过期时，先检查缓存中其他格式的URL是否可用，避免立即重新请求。
• 提前主动刷新：在URL过期前5-10分钟主动重新请求新的URL，替换数据库中的旧记录，避免用户播放时才触发刷新导致卡顿。
• 添加降级机制：如果请求新URL失败，尝试使用缓存中未过期的其他分辨率URL，保证基本播放功能可用。

3. 遗漏的要点 #

• 客户端标识合规性：YouTube官方更认可WEB端客户端标识，WEB端的请求逻辑更稳定、限制更少，你切换到WEB客户端解决问题就是关键验证。
• 请求头完整性：WEB端请求通常需要添加更多真实的请求头（比如User-Agent、Referer），模拟真实浏览器请求，降低被拦截的概率。
• 错误重试机制：针对偶尔出现的错误，添加自动重试逻辑（比如重试2-3次，每次间隔1-2秒），避免单次请求失败就返回错误给用户。
• 区域与版权限制处理：部分视频有区域或版权限制，即使切换到WEB客户端，也需要处理这类情况（比如提示用户无法播放）。

4. 其他播放器正常工作的原因 #

主流播放器要么使用官方嵌入代码（通过YouTube的iframe播放器，由YouTube负责处理URL获取和过期逻辑），要么使用更完善的客户端标识和请求模拟，同时具备多客户端 fallback 机制——当某个客户端请求失败时，自动切换到其他客户端标识重新请求，保证播放稳定性。

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