Media API で地域フィルタリングを行う

Brightcove の地域フィルタリング機能を使用して、視聴者の地理的位置に基づいて、コンテンツへのアクセスを制限することができます。たとえば、法的な理由で米国およびカナダ以外に配信できない動画がある場合、動画の地域フィルタリングで、許可された国以外の視聴者がコンテンツにアクセスできないように設定できます。地域フィルタリングを使用してプレーヤへのアクセスを制限することもできます。フィルタリングは、ISO-3166 で定義された 240 を超える国と地域に対応しています。

地域フィルタリングによる動画の制限は Brightcove Pro および Enterprise のパブリッシャにてご利用いただける機能であり、追加費用がかかります。アカウントをアップグレードして Quova 地域フィルタリングを追加したい場合は、Brightcove へお問い合わせください。

地域フィルタリングでは、選択した国を除外したり、または選択した国に限定することができます。つまり、対象コンテンツへのアクセスを可能にする国を指定することができます（限定）。また逆に、対象コンテンツへのアクセスを不可にする国を指定することもできます（除外）。このトピックでは、Media API を使用して、動画の地域フィルタリング プロパティを設定する方法について説明します。また動画の地域フィルタリング プロパティを、Media モジュールの [動画の編集] の [公開期間] タブ、あるいは FTP バッチ プロビジョニングを使用して設定することができます。

動画の地域フィルタリング プロパティ

動画の地域フィルタリングは、Video オブジェクトの 3 つのオプション プロパティによって制御します。

Media API の書き込みメソッドで地域フィルタリングを設定する

動画に地域フィルタリングのプロパティを設定するには、create_video または update_video メソッドを使用します。たとえば、ある動画をマルタ（mt）のみで視聴できるよう指定する JSON は、次のようになります。

{"method": "create_video",
 "params": {"token" : "riBfgveLvpRb-rHGiBBouSAXs-Q8NmphGxt0z04kE.",
            "video" : {"id":38,"name":"The Maltese Falcon",
                       "shortDescription":"The stuff dreams are made of.",
                       "geoRestricted":true,"geoFilterExclude":false,
                       "geoFilteredCountries":["mt"]},
            "filename":"malteseFalcon.mp4",}
}

この動画を、リストにある国以外どこからでも視聴できるようにするには、次のような JSON で動画を更新します。

{"method": "update_video",
 "params": {"token" : "riBfgveLvpRb-rHGiBBouSAXs-Q8NmphGxt0z04kE.",
            "video" : {"id":38,"name":"The Maltese Falcon",
                       "shortDescription":"The stuff dreams are made of.",
                       "geoRestricted":true,"geoFilterExclude":true,
                       "geoFilteredCountries":["mt","cy","es","gr"]},
           }
}

地域フィルタリングのエラー メッセージ

地域フィルタリングのプロパティを含む関数呼び出しに対して、次のエラー コードを受け取ることがあります。