Vimeo APIへのすべてのリクエストには認証トークンが必要です。認証トークンは、誰がリクエストをしているのか、そしてそのユーザーがどのようなアクションを実行できるのかを示します。この記事では、Vimeo APIの認証トークンを生成する方法を説明します。
記事の内容：
パーソナルアクセストークンを生成する前に知っておくべきこと
- 開始するには、開発者ポータルでAPIアプリを作成する必要があります。これは、APIとやり取りし、認証を要求するものです。APIアプリの作成方法についてご覧ください。
- パーソナルアクセストークンは、APIリクエストを認証するための一意のコードです。
- このトークンは、Vimeoアカウントに関連付けられ、アカウントと動画のプライベートメタデータにアクセスできる「認証済み」、またはAPIアプリでのみ許可され、Vimeo.comで一般公開されたメタデータの読み取りにのみ使用できる「認証なし」にすることができます。
- 他のユーザーにアプリのVimeoアカウントへのアクセスを許可する必要がある場合は、利用可能な他の認証ワークフローのいずれかを使用してアクセストークンを生成する必要があります。
- 認証ワークフローに関する完全なドキュメントは、開発者サイトの「認証に関する操作」からご覧いただけます。
- トークンは安全に保管してください。アクセス権を持つ人は誰でも、アプリまたはアカウントに代わってリクエストを行うことができます。
パーソナルアクセストークンを生成する方法
Vimeoのアプリページからパーソナルアクセストークンを生成できます。手順は以下のとおりです。
- アプリのページに移動します。
- 認証に使用するアプリを選択するか、まだ作成していない場合はアプリを作成します。
- 左側のナビゲーション列の「認証」ヘッダーでアクセストークンを生成を選択します。
- アカウントのプライベートデータを操作する必要がある場合は、「認証済み（あなた）」を選択します。一般公開メタデータの読み取りのみが必要な場合は、「認証なし」を選択します。
- 「認証済み」を選択した場合は、スコープの見出しの下で、トークンに付与したい機能にチェックを入れます。これらのスコープの定義は開発者サイトでご覧いただけます。
- ⚠️注：プライベート動画またはプライベートメタデータにアクセスするには、必要な他のスコープに加えて「プライベート」スコープを選択する必要があります。「一般公開」のみを選択した場合、個人情報にアクセスすることはできません。
- ai — Vimeo AI APIエンドポイント (トランスクリプション、字幕翻訳、オーディオダビング、AskAI) へのアクセスを有効化します。AIアクションをプログラムでトリガーしたいエンタープライズユーザーに必須です。
- 生成を選択します。ページがリロードされ、トークンがパーソナルアクセストークンセクションに表示されます。
- トークン文字列をコピーし、安全な場所に保存します。このトークンは、スクリプトやアプリでVimeo APIとやり取りするために使用できます。
推奨される次のステップ
認証の使用に関する詳細については、開発者ドキュメントをご覧ください。