カスタムアプリケーションでVimeo APIを使用している場合、および/または動画サムネイルのURLをキャッシュしている場合、特にサムネイルURLがアプリケーションまたはサイトでハードコーディングされている場合（リンク構造が自動的に更新されないことを意味します）は、サムネイルが動画プレーヤーに表示されなくなる可能性があります。
これらのユースケースでサムネイルを修正するには、API 呼び出しを開始してVimeoサーバーから動画のサムネイルを取得する必要があります。Vimeoでは、動画のサムネイルURLをキャッシュするのではなく、これを定期的に実装することをお勧めします。また、可能であればこれらの呼び出しをバッチ処理することをお勧めします。これにより、より効率的になります。
Vimeo APIを介してサムネイルURLを取得する方法に関する追加の資料は、Vimeoのデベロッパサイトにある「Vimeoデベロッパ：特定の動画サムネイルを取得」でご覧いただけます。
動画のサムネイルURLを取得する手順は次のとおりです：
-
- Vimeoアカウントにログインし、https://developer.vimeo.com/ にアクセスします。
-
アプリをまだお持ちでない場合は、新規アプリをクリックします。
- アプリに名前と説明を付けます
- いいえを選択します
- アプリを作成を選択します。
-
アプリの設定ページで、APIへの呼び出しを認証するためのアクセストークンを作成する必要があります。
- 認証 > 一般から、認証済みを選択します
- スコープで、プライベートを選択します。
-
生成をクリックします。
- 生成されたトークンをコピーして、テキストエディタに保存します。このトークンは後で必要になります。
-
APIクライアントアプリケーション（Postmanなど）で、「GET」リクエストを作成し、次のURLを入力します：
- https://api.vimeo.com/me/videos
- 認証に必要なトークンがGETリクエストのヘッダー（ https://developer.vimeo.com/api/authentication）に含まれていることを確認します。 Postmanを使用している場合は、認証タブに移動し、タイプのドロップダウンでBearerトークンを選択して、トークンテキスト欄に貼り付けます。
- リクエストを送信します。
-
ペイロードには、動画に関する多くの情報が含まれます。必要な結果を特定するには「Vimeoデベロッパ：動画のサムネイルをすべて取得」に記載されている追加パラメータを使用することができます。
-
例：https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
- これには、動画 ID、動画のタイトル、サムネイルURLが含まれ、最初の100本の動画が含まれます。
- サムネイルのURLは、各動画の「写真」の下に表示されます。
-
例：https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
この動画チュートリアル：Vimeo API を使用して動画サムネイルのURLを取得で、手順のウォークスルーをご覧ください。