YouTube の埋め込みでエラー 153 が出る原因と直し方

エラー 153 は、YouTube のプレーヤーがどのサイトに埋め込まれたかを判別できないときに出ます。原因は Referer ヘッダーが送信されていないことです。Web サイト、WebView、アプリ別の直し方。

YouTube の動画をページに埋め込むと、プレーヤーは表示されるのに、動画の代わりに黒い画面で「Error 153. Video player configuration error」(エラー 153: 動画プレーヤーの設定エラー)と出て、「YouTube で見る」のリンクが表示されることがあります。動画にも埋め込みコードにも問題はありません。足りないのは、誰が埋め込んでいるかという情報です。

原因:プレーヤーが、どのサイトに埋め込まれたかを判別できない

YouTube の開発者向け規約ははっきりしています。Required Minimum Functionality(必須の最低限の機能)のページには、埋め込みプレーヤー(IFrame Player API を含む)を使うものはHTTP の Referer ヘッダーで自分を名乗らなければならない、と書かれています。通常はブラウザが自動で送りますが、同じページでは、それを送らなくする設定を使わないこと、そして strict-origin-when-cross-origin のリファラーポリシーを使うことが推奨されています。

Referer がない状態、またはサイトを特定できない Referer でプレーヤーが読み込まれると、再生を拒否してエラー 153 を表示します。実際にデバッグした開発者(Simon Willison など)も、原因はまさにそこだったと突き止めています。Google のページには 153 という番号そのものは出てきませんが、そこに書かれた対処法でこのエラーは消えます。

Web サイトで Referer を消してしまうもの

  • Referrer-Policy ヘッダーが no-referrer または same-origin になっている。フレームワークやセキュリティ設定によっては最初から付いています。Willison のケースでは、same-origin を送る Django の SecurityMiddleware でした。
  • ページの head にある meta タグ: <meta name="referrer" content="no-referrer">
  • iframe そのものに付いた referrerpolicy 属性。埋め込み用のプラグインが付けることがあります。
  • プレーヤーを表示するために開くウィンドウに付けた noreferrer。YouTube のページでも使わないよう書かれています。

Web サイトでの直し方

YouTube が推奨するポリシーを、ヘッダーで送ります:

Referrer-Policy: strict-origin-when-cross-origin

ヘッダーを変更できない場合は、meta タグで:

<meta name="referrer" content="strict-origin-when-cross-origin">

そのうえで、より優先される設定が上書きしていないか確認します。iframe の referrerpolicy 属性は削除するか、同じ値にしてください。このポリシーがほかのサイトに送るのはオリジン(例:https://example.com)だけで、パスまでは送らないので、プライバシー面で失うものはほとんどありません。なお Willison によると、埋め込み先をyoutube-nocookie.com に変える方法は効いたり効かなかったりで、解決したのはポリシーの修正でした。

アプリの中での直し方(WebView、Electron、Tauri)

アプリのほうがこのエラーに当たりやすいのは、ページが Web サイトから読み込まれていないからです。ローカルファイルや独自スキーム(file://、app://、tauri://localhost)から読み込んだページには送るべき Web のオリジンがなく、プレーヤーは使える Referer を受け取れません。YouTube のページには、プラットフォームごとの対処法が載っています:

  • ローカルの HTML を読み込むモバイルの WebView: baseUrl パラメーターを設定します。これが Referer になります。
  • iOS の SFSafariViewController: Referer を設定できないので、代わりにプレーヤーのorigin パラメーターを指定します。
  • デスクトップアプリ: リクエストに HTTP ヘッダーとして Referer を付けるか、WebView がそれを送るように設定します。

WebView のヘッダーを制御できない場合の最後の手段:自分が持っている本物の https ドメインに、プレーヤーを埋め込んだ小さなページを置き、アプリからはそのページを iframe で表示します。プレーヤーからは、あなたのドメインが埋め込み元に見えます。

私たちがこのエラーに出会った経緯

私たちは Tauri で作ったメニューバーアプリ Webstarted Toolbox を開発していて、その Media ウィジェットで YouTube の動画を再生します。画面は tauri://localhost で動いていて、これは有効な Web のオリジンではないため、youtube.com/embed を直接 iframe にすると毎回エラー 153 になりました。解決したのは上の最後の方法です。ウィジェットは、私たちの https ドメインに置いた小さなページを表示し、そのページが正しい Referer を送ってプレーヤーを埋め込みます。動画そのものは Google から視聴者へ直接配信され、私たちのサーバーを通るのはその小さなページだけです。

動画を見たいだけの場合

エラーの原因は、動画を埋め込んだサイトやアプリの側にあり、あなたの側ではありません。「YouTube で見る」のリンクから youtube.com で再生できます。ひとつだけ確認したいのは、すべてのリクエストから Referer を消すブラウザ拡張機能やプライバシー設定です。同じヘッダーを消してしまうので、正しく設定されたサイトでもエラー 153 の原因になります。

参考資料