Analytics RESTAPIからBrightcoveAnalyticsAPIへの移行

はじめに

ビデオクラウド分析 APIは、Ooyala アナリティクス REST API と非常によく似ています。

また、Video Cloud Studio の分析モジュールには堅牢なカスタムレポートビルダーが含まれているため、多くの場合、API をまったく使用する必要がない場合があります。

以下のセクションは、2 つの API のさまざまな側面に対応しています。

• 認証
• レポート
• パラメーター
• 寸法
• フィルタ
• メトリック

[認証]

ブライトコーブ API リクエストの認証は、Ooyala REST API の場合とは少し異なります。詳細については、ブライトコーブ API リクエストの認証を参照してください。

レポート

Ooyala アナリティクス REST API /reportsの単一のエンドポイントは、ブライトコーブアナリティクス API に非常に密接に対応しています。/dataエンドポイント。主な違いは、Ooyala GET APIはとの両方を許可しPOST、後者はURLパラメータではなくリクエスト本文にいくつかのデータを渡すために使用されていることです。長いデータ文字列を許可します。

パラメータ

リクエストのパラメーターは、2 つの API でも同様です。相違点がどこにあるかを示すために、以下の表で詳しく説明しています。

[寸法]

Ooyala および Brightcove Analytics API はいずれも、データを「ディメンション」と呼ばれるバケットにグループ化しています。これらは同様の方法で使用されますが、API には複数のディメンションを組み合わせる方法に関するルールが多少異なります。ブライトコーブには、より広範なディメンションセットがあります。見るサポートされている寸法の組み合わせ BrightcoveAPIの詳細については。以下の表に、詳細な比較を示します。

[フィルタ]

フィルターは、次の 2 つの API でほぼ同じように機能します。

      
        // Ooyala
        filter={dimension1}=={value1};{dimension2}=={value2}
      
        // Brightcove
        where={dimension1}=={value1};{dimension2}=={value2}
      

メトリックス

レポートで返されるmetrics (ブライトコーブ API の場合: fields ) は、ブライトコーブ Analytics API で要求されたディメンションによって異なります。ディメンションとフィールドに埋め込まれたツール。特定のディメンションまたはディメンションの組み合わせに対して返すことができるフィールドを確認します。

Ooyala API は、何も指定されていない場合はすべてのメトリクスを返しますが、Brightcove API は、リクエストに含めない限り、ディメンション（組み合わせ）によって異なる少数のデフォルトメトリックセットのみを返します。fields

ブライトコーブの項目には、以下を除くすべての Ooyala メトリックスと同等の項目が含まれます。

• uniq_plays_requested
• uniq_displays
• uniq_video_starts

Brightcove Analytics APIは、Ooyala アナリティクスでは利用できないその他の指標の数を返すこともできます。