トラブルシューティング

このページでは、Video Stitcher API に関する問題を解決する方法について説明します。このページで説明するエラーは、Video Stitcher API に固有のものです。Google APIs の一般的なエラーについては、Cloud APIs のエラーのページをご覧ください。

最初のエラーのみが返されます。リクエストで複数のエラーが発生した場合は、返されたエラーを修正し、リクエストを再試行して次のエラーを確認する必要があります。

セッションの作成時に再生リストを取得できない

次の問題は、Video Stitcher API が、指定された sourceUri から動画マニフェストを取得できない場合に発生します。

{
  "error": {
    "code": 404,
    "message": "got status code 403 when fetching playlist from URI \"https://example.com/manifest.m3u8\"",
    "status": "NOT_FOUND",
  }
}

この問題を解決する手順は次のとおりです。

  1. 指定された sourceUri が有効な動画マニフェストにリンクしていることを確認します。

    • curlsourceUri と併用します。マニフェストを公開することを意図している場合は、URL が一般公開されていることを確認してください。
    • sourceUri が正しく、動画マニフェストに URL 署名が必要な場合は、次のステップに進みます。
  2. CDN キーが、リクエストと同じリージョン内の Video Stitcher API で登録されていることを確認します。

    • sourceUri ホスト名と一致する CDN キー構成が存在することを確認します。構成が存在しない場合は、Video Stitcher API で CDN キーを登録します。構成がサービスに反映されるまで少なくとも 5 分は待ちます。
    • 構成が存在する場合は、次のステップに進みます。
  3. URL の署名に使用した秘密鍵が正しくないと思われる場合は、正しい秘密鍵で登録済みの CDN 鍵を更新することをおすすめします。

CDN キーが古い

最近 CDN キーを登録または更新し、Video Stitcher API が新しい構成を使用して URL の署名を開始していない場合は、次の手順で問題を診断します。

  1. CDN キーが Video Stitcher API で最近登録された場合は、更新が伝播されるまで少なくとも 5 分は待ちます。問題が解決しない場合は、次のステップに進みます。

  2. リージョンの 1 つのホスト名に 1 つの CDN キーのみが登録されていることを確認します。 複数の CDN キーが同じホスト名で登録されている場合、Video Stitcher API は、URL に署名するためにいずれかの CDN キーを選択します。

ライブ セッションに挿入された広告がない

ライブ セッションに広告が挿入されていない場合は、次の手順で問題を診断します。

  1. ソースのライブ ストリームによって、ミッドロール挿入点がマニフェストに挿入されていることを確認します。ソース動画セグメントを広告セグメントに置き換えるように Video Stitcher API に指示するには、次の広告マーカーがライブ ストリームの動画マニフェストに存在している必要があります。

    • ソース動画マニフェストに広告マーカーがない場合は、エンコーダがミッドロール挿入点をトリガーしていないか、サポートされている広告マーカーを挿入するよう変更する必要があります。

    • ソース マニフェストに広告マーカーが明瞭に表示される場合は、次のステップに進みます。

  2. 指定した広告タグから空でない VAST レスポンスが返されることを確認します。

    • この広告タグをウェブブラウザ(Chrome など)のアドレスバーコピーし、空でない VAST レスポンスが返されることを確認します。以下は、空の VAST レスポンスです。

      <VAST version="3.0"/>
      
    • 空の VAST レスポンスが返された場合は、問題は広告タグです。 広告サーバーで広告タグが正しく設定されていることを確認します。

    • VAST レスポンスが入力された場合は、curl を使用して広告タグをリクエストします。 一部の広告サーバーでは、User-Agent ヘッダーを指定する必要があります。次の curl コマンドを試してみてください。

      curl AD_TAG_URI
      
    • curl コマンドによってと空の VAST レスポンスが返される場合、User-Agent ヘッダーを curl コマンドに追加します。

      curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
          AD_TAG_URI
      
    • 入力された VAST レスポンスが返された場合、問題は、ライブ セッションの作成時に User-Agent ヘッダーを Video Stitcher API に渡す必要があるということです。Video Stitcher API は、広告タグを実行して広告を取得するときにそのヘッダーを使用します。

    • それでも空のレスポンスが返される場合は、指定された広告タグに問題があります。広告タグが正しいこと、および広告タグマクロの値も正しいことをお客様に確認します。

    • お客様の広告タグの問題が解決しても、広告が挿入されていない場合は、次のステップに進みます。

  3. ライブ セッションを検査します。 影響を受けているセッションで、広告サーバーから広告が返されることが示されている場合は、次のステップに進みます。

  4. 広告がない場合の次の可能性のある問題は、広告の再エンコードによるものです。この API は、最初の出現時に広告を再エンコードし、ソース動画と一致するように広告をエンコードします。通常、広告のエンコードには数分かかります。数分後に新しいセッションの作成を再試行し、広告が挿入されるかどうかを確認します。

    広告が挿入されなかった場合、広告がエンコードされていないことが原因である可能性があります。 広告メディアの URL にアクセスできない可能性があります。この場合、お客様は広告プロバイダと協力して、広告メディアの問題を特定する必要があります。

VOD セッションに広告が挿入されない

  1. 提供された広告タグから、空でない VAST または VMAP のレスポンスが返されることを確認します。 提供された広告タグを次の手順で使用します。

    • 広告タグをウェブブラウザ(Chrome など)のアドレスバーにコピーして、空でない VAST、VMAP、または SmartXML レスポンスが返されることを確認します。 以下は、空の VAST レスポンスです。
    • 広告タグをウェブブラウザ(例: Chrome、Firefox など)のアドレスバーに入れ、空でない VAST、VMAP、または SmartXML のレスポンスが返されることを確認します。空の VAST レスポンスは次のようになります。

      <VAST version="3.0"/>
      

      以下は、空の VMAP レスポンスです。

      <VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0"/>
      
    • 空の VAST レスポンスが返された場合は、問題は広告タグです。 広告サーバーで広告タグが正しく設定されていることを確認します。

    • VAST レスポンスが入力された場合は、curl を使用して広告タグをリクエストします。 一部の広告サーバーでは、User-Agent ヘッダーを指定する必要があります。次の curl コマンドを試してみてください。

      curl AD_TAG_URI
      
    • curl コマンドによってと空の VAST レスポンスが返される場合、User-Agent ヘッダーを curl コマンドに追加します。

      curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
          AD_TAG_URI
      
    • 入力された VAST または VMAP のレスポンスが返された場合、問題は、VOD セッションの作成時に User-Agent ヘッダーを Video Stitcher API に渡す必要があるということです。Video Stitcher API は、広告タグを実行して広告を取得するときにそのヘッダーを使用します。

    • それでも空のレスポンスが返される場合は、指定された広告タグに問題があります。広告タグが正しいこと、および広告タグマクロの値も正しいことをお客様に確認します。

    • お客様の広告タグの問題が解決しても、広告が挿入されていない場合は、次のステップに進みます。

  2. VOD セッションを検査します。影響を受けているセッションで、広告サーバーから広告が返されることが示されている場合は、次のステップに進みます。

  3. 広告がない場合の次の可能性のある問題は、広告の再エンコードによるものです。この API は、最初の出現時に広告を再エンコードし、ソース動画と一致するように広告をエンコードします。通常、広告のエンコードには数分かかります。数分後に新しいセッションの作成を再試行し、広告が挿入されるかどうかを確認します。

    広告が挿入されなかった場合、広告がエンコードされていないことが原因である可能性があります。 広告メディアの URL にアクセスできない可能性があります。この場合、お客様は広告プロバイダと協力して、広告メディアの問題を特定する必要があります。