サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    概要: ビデオデータエンドポイント

    このトピックでは、Analytics API の動画データエンドポイントの使用方法について説明します。

    はじめに

    ビデオデータエンドポイントは、特定のビデオの特定のデータを取得するための迅速な方法を提供します。現在のリクエストでは、動画の全視聴回数が返されます。将来、追加のデータが返される可能性があります。このエンドポイントの主な使用例は、トラフィックの多いページのプレーヤーに常時ビュー情報を配信することです。この場合、Analytics API遅すぎるでしょう。

    終点

    ビデオデータリクエストのエンドポイントは次のとおりです。

        https://analytics.api.brightcove.com/v1/alltime/accounts/{$account_id}/videos/{$video_id}

    すべてのリクエストはGETです。

    認証

    へのすべてのリクエストAnalytics API BrightcoveのOAuthサービスを介して認証されます。

    認証は、Authorizationヘッダーで渡されたアクセストークンに基づいています。

        Authorization: Bearer {your token}

    のクライアント資格情報を取得できますAnalytics APIそれらを使用して一時的なアクセストークンを取得します-を参照してくださいOAuthの概要クライアントの資格情報とアクセストークンを取得するために使用できるさまざまなアプローチの説明については、 API資格情報の管理 Studioを介してクライアント資格情報を取得する方法については

    応答

    リクエストへの応答は、次の形式のJSONになります。

        {
        "alltime_video_views": 103123
    }

    可能な実装

    動画データエンドポイントを使用して、動画がプレーヤーに読み込まれたときに動画の常時視聴回数を表示する方法は次のとおりです。

    1. 動画IDで5〜10分間視聴を保存するようにキャッシュを設定します。
    2. サーバーまたはページにロジックを作成して、最初にキャッシュをチェックして、現在のビデオの常時ビデオビューデータがすでに存在するかどうかを確認し、存在する場合はそれを使用します。
    3. 値がまだキャッシュされていない場合は、ビデオ情報エンドポイントに要求して値を取得し、ページに表示するとともに値をキャッシュに保存します。
    4. 動画情報エンドポイントへのリクエストがタイムアウトしたり失敗したりした場合に備えて、必ず例外処理を設定してください。すべての動画の視聴回数が表示されない場合や、最後の値を使用する場合があります。

       

    実装図
    実装図