この機能には、Vimeo Standard、Advanced、Pro、Business、Premium、または Enterpriseプランが必要です。
APIを使用してアカウントから動画ファイルの直接リンクを取得できます。動画応答オブジェクトには、play、files、downloadなど、これらのファイルにアクセスするためのいくつかのフィールドが含まれることがあります。この記事では、これらのフィールドの意味と使用方法について説明します。
記事の内容：
始める前に知っておくべきこと
- 動画ファイルの直接リンクを取得するには、public、private、video_filesスコープを持つ認証トークンを使用して、動画のエンドポイントにリクエストを送信する必要があります。
- その動画応答には、ファイルとダウンロードリンクのフィールドが含まれます。
- これらのすべてのフィールドで返されるリンクは、当社のCDNの1つにある実際の動画ファイルの場所へのHTTP 302リダイレクトです。
- 当社のCDN上のこれらのファイルの場所には有効期限があり、数時間ごとに失効するため、常に提供されたとおりにリダイレクトリンクを使用する必要があります。
- アップロードされた動画（ライブ動画を除く）のHLSファイルは、映像が最適化されトランスコーディングされた後にダウンロードできます。
「play」、「files」、「download」フィールドについて理解する
動画のメタデータをリクエストする場合、応答には動画ファイルにアクセスするための3つの異なるフィールドが含まれることがあります。それぞれ異なる目的を持っています。
-
play：これらのリンクは再生用に最適化され、24時間で期限切れになるため、セキュリティが強化されます。
- サードパーティのプレーヤーにはplayフィールドを使用することをお勧めします。
-
files：filesフィールドには、動画のサイズやファイルサイズなどのリンクと関連メタデータが含まれています。これらのリンクには有効期限がありません。
- これらのリンクには有効期限がないため、サードパーティのプレーヤーでの使用はお勧めしません。
- download：downloadフィールドには、動画ファイルへの有効期限付きリンク（24時間有効）、各リンクの有効期限、および関連するメタデータが含まれています。これらのリンクには、ファイルをブラウザで再生するのではなくダウンロードするようにウェブブラウザに指示するヘッダーが含まれています。
推奨される次のステップ：
開発者ガイドのVimeo API：特定のビデオの取得、Vimeo API：再生応答、Vimeo API：動画応答を参照してください。