Media API 全般

このトピックでは、JavaScript から Media API のクエリを行うための基本的な手順を示します。このトピックの読者は、プログラミング言語の JavaScript に習熟しており、ブラウザが JavaScript で HTTP 要求をする際に抵触する、クロスドメインに関するセキュリティの制約について理解していることを前提としています。続きを読む前に、以下のトピックも確認してください。

このトピックでは、Media API の読み取りメソッドが返す Video、Playlist、Image、Rendition、CuePoint、LogoOverlay オブジェクトのリファレンスを提供します。

2007 年 3 月に Brightcove Media API がベータ版として初めてリリースされてから、Media API の使い方について Brightcove とお客様が経験を重ねる中で、Brightcove は数点の変更を行いました。このトピックでは、現時点までに行った変更の一覧を示します。

このトピックでは、Video Cloud Studio の [API 管理] ページを使用して、API トークンを表示およびコピーする方法を説明します。

Video Cloud Media API を使用する場合、メソッド コールにはトークンが必要です。トークンは Video Cloud から各アカウントに対して発行され、API を使用したアカウントへのアクセスを可能にします。トークンは、token=<tokenString> という URL パラメータとして、呼び出しに付加します。tokenString は URL エンコードしたトークンです。

注：通常、Media API トークンの末尾は 1 つ以上のドット（.）です。API トークンを使用するときは、必ずこのドットも入れてください。カットアンドペーストをすると、忘れる場合が多いようです。

このトピックでは、Video Cloud Studio の [API 管理] ページを使用して、メディア API トークンを表示およびコピーする方法を説明します。

ブラウザのセキュリティ ルールは、Media API を使用した JavaScript の通信を妨げる可能性のある障害となります。解決策の 1 つはサーバーサイド プロキシを使用することです。自由な通信が可能で、しかもトークンをセキュアに保てる（トークンを JavaScript コードで持つ必要がなくなるため）というメリットがあります。もう 1 つの有効な手段が、動的スクリプト タグです。

スクリプト タグの src 属性は、ブラウザによるドメインチェックを受けません。つまり、src に別のサーバーの URL を設定することにより、クロスドメインの通信を効果的に許可できるということです。ただし、src を要求したときにサーバーから返されるのは、有効な JavaScript である必要があります。幸い、Brightcove の Media API をはじめとした多くのサービスで、「callback」パラメータの指定が可能です。こうすると、callback パラメータの値を名前とする関数の呼び出しで、JSON の応答がラップされます。次に例を示します。

Media API は HTTP 経由でアクセスする REST ベースのサービスで、クライアントサイドおよびサーバーサイド アプリケーションとの連携が非常に容易にできます。しかし、システム設計当初からセキュリティを考慮していなかった場合には、この容易さがアプリケーションの弱点となることがわかっています。

いかなる Web アプリケーション開発でも、セキュリティの設計は欠かせません。具体的には、システム内の機密情報やリソースを特定し、それらに対するアクセスをどこでどのように行うかを決定し、その場所とアクセス制御により効果的に無許可のユーザーを排除し、情報をセキュアに保つ、ということです。

このトピックで推奨するのは、アプリケーションにおける Media API とのインタラクションに関する事項であり、アプリケーションの他の部分はすでにセキュアな状態であることを前提としています。

何が危険かを知る

Brightcove API におけるセキュリティの要は、API トークンです。API トークンは API 呼び出しに付加する英数字の文字列で、その目的は、使用しているアプリケーションをシステムに認証させること、およびトランザクションを許可することです。用途別に次の 3 種類のトークンがあります。

検索エンジンに対するページの最適化は、Media API を使用することではるかに容易になります。検索エンジンによって検出可能なサイトの深部まで、動画のメタデータを取り込むことができるからです。メタデータを利用したページを、ブラウザに到達する前に、アプリケーション サーバで Media API を使用して動的に生成することがポイントです。

HTML ボックスに戻る

Flash は Web サイトに最適ですが、Flash 動画のコンテンツは検索エンジンにインデックスされません。また、ページ上のスクリプトが取得するコンテンツも、インデックスされません。検索エンジンにインデックスされるのは、ページがロードされた時点でページ上に存在する、純粋な HTML のコンテンツのみです。検索エンジンのクローラは、その文字列をインデックスするだけです。ページ上にメタデータがなければ、検索エンジンにはインデックスされません。（注:動画検索エンジンはまた異なり、コンテンツを取得するためにページを巡回しません。）

プレーヤの API アクセスを有効にする方法