トラブルシュート

YouTube埋め込みが表示されないときに相手へ伝える確認依頼の書き方

YouTubeを埋め込んだHTMLを共有した後に「動画が出ない」と言われると、何を確認してもらえばよいか瞬時に判断しにくいものです。この記事では、原因の絞り込みに必要な情報を相手からスムーズに引き出すための確認依頼メッセージの書き方を具体的に解説します。

よくある原因

「動画が見えない」という報告は「再生ボタンが押せない」「動画エリアが空白」「エラーメッセージが出ている」など複数の状態を含んでいます。どの状態かを最初に確認することで、iframeのURLミスなのか・動画の公開設定なのか・ネットワーク制限なのかの判断が一気に絞れます。

相手のブラウザが広告ブロッカーを使っているか、社内ネットワーク上にいるかで症状が変わります。同じHTMLが自分のPCでは正常に動いても、相手の会社PCでは完全に白紙になることがあります。最初の確認依頼で使用環境を聞くことが遠回りに見えて実は最短の解決策です。

  • 相手がログインなしで開ける状態か確認する
  • PCとスマホで最低1回ずつ表示を確認する
  • 内部情報・個人情報・不要な外部送信が残っていないか見る
  • レビュー期限と修正時の差し替え方を決めておく

自分側で確認すること

確認依頼を送る前に、自分のPCのシークレットウィンドウで同じURLを開き動画が再生されるかを確認します。自分側でも再生できない場合はHTMLのiframe src・動画の公開設定・ネットワーク環境を先に調べます。自分側で再現する場合は相手への確認依頼より先にHTMLを修正するほうが効率的です。

動画のYouTube設定で「埋め込みを許可する」がオンになっているかをYouTube Studioで確認します。これがオフだと相手の環境に関係なく全員に表示されません。確認依頼の前にこの設定を必ずチェックしてから相手へのメッセージを送ります。

  • HTML内の外部script・form action・iframeを確認する
  • APIキーやトークンらしき文字列がないか検索する
  • 画像・CSS・JSのパスが公開後も解決できるか見る
  • noindexと認証を混同せず、必要なら両方設定する

相手側で確認すること

確認依頼メッセージに含めるべき質問は3つです。「①動画のある場所に何が見えていますか(空白・グレーボックス・エラーメッセージなど)、②お使いのブラウザと端末を教えてください、③シークレットウィンドウ(またはプライベートブラウジング)で同じURLを開いても同じですか」。この3問で原因の大半が特定できます。

相手がスマートフォンを使っている場合の追加質問として「LINEやInstagramなどのアプリ内から開いていますか」を入れます。アプリ内ブラウザはYouTubeのiframeをブロックする場合があるため、SafariやChromeで直接開くよう案内するだけで解決するケースがあります。

  • HTML内の外部script・form action・iframeを確認する
  • APIキーやトークンらしき文字列がないか検索する
  • 画像・CSS・JSのパスが公開後も解決できるか見る
  • noindexと認証を混同せず、必要なら両方設定する

再発防止の運用

確認依頼のメッセージを毎回ゼロから書かずに済むよう、テンプレートを作成します。「お送りしたURLでYouTube動画が表示されない場合、下記3点を教えていただけますか。①動画エリアに何が表示されているかのスクリーンショット、②ご使用のブラウザ名、③シークレットウィンドウでも同様か」という形式でNotionやメモアプリに保存しておきます。

相手から「シークレットでは見えた」と返ってきた場合の対応もテンプレート化します。「ブラウザ拡張(広告ブロッカーなど)が影響しているようです。拡張機能の設定画面から一時的に無効にして再読み込みをお試しください」という案内文を用意しておくと、やり取りが2往復で完結します。

  • HTML内の外部script・form action・iframeを確認する
  • APIキーやトークンらしき文字列がないか検索する
  • 画像・CSS・JSのパスが公開後も解決できるか見る
  • noindexと認証を混同せず、必要なら両方設定する

よくある質問

確認依頼を送ったら「エラーは出ていないが動画エリアが完全に空白」と言われました。

iframeのsrc URLが無効か、CSSでiframeのheightが0pxになっている可能性があります。iframe srcの動画IDが正しいか確認し、CSSでheightを明示的に指定(例:height:315px またはaspect-ratio:16/9)してください。

相手が「会社のPCでは見えないが自宅PCでは見える」と言っています。どう対応すればよいですか?

会社のネットワークがYouTubeへのアクセスをブロックしている可能性が高いです。IT部門にyoutube.comとyoutu.beの通信許可を依頼するよう案内するか、動画を別のホスティング環境に移してHTMLのsrcを変更する方法を検討してください。

確認依頼を送らずに問題を解決する方法はありますか?

共有前にギガサイト便などのプレビューURL機能を使って別端末・別ブラウザで表示確認すれば、多くの問題は共有前に発見できます。確認依頼が不要になるよう、送付前の自己チェック工程を習慣化することが最も効率的です。

関連記事

トラブルシュート

YouTube埋め込みが表示されないときの原因と直し方

YouTubeのiframeをHTMLに埋め込んだが閲覧者に動画が表示されない問題で困っている方向け。動画の公開設定・埋め込み許可・ブラウザのCSP・ネットワーク制限など原因別の確認方法と修正手順を解説します。

5分で読める
トラブルシュート

PDF埋め込みが表示されないときの原因と直し方

AI生成HTMLのPDF埋め込みが共有先で表示されない問題に直面したWeb担当者・デザイナー向け。ブラウザのPDFビューア設定差・パス問題・CSPエラーを原因別に切り分け、確実に表示させるための修正方法を解説します。

6分で読める
「トラブルシュート」の記事をもっと見る →