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