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 の原因になります。
参考資料
- YouTube API Services: Required Minimum Functionality(Google for Developers、英語)
- Error 153 Video player configuration error on YouTube embeds(Simon Willison、英語)
- Referrer-Policy(MDN)