Vimeo APIへのすべてのリクエストには、認証トークンが必要です。認証トークンは、リクエストを行っているユーザーと、ユーザーが実行できるアクションを通知します。
パーソナルアクセストークンは、デベロッパサイトで生成されるトークンで、APIリクエストを認証するために使用できます。このトークンはVimeoアカウントに関連付けて認証することが可能です。またはAPIアプリにのみ許可し、vimeo.comで一般公開されているメタデータの読み取りにのみ使用できるよう、認証なしにできます。
他のユーザーにVimeoアカウントへのアクセスを許可する必要がある場合は、他の利用可能な認証ワークフローを使用してアクセストークンを生成する必要があります。認証に関するドキュメントは、デベロッパサイトでご確認いただけます。
パーソナルアクセストークンを生成するには、次の手順に従います。
- アプリページに移動します。
- 認証するアプリを選択します。
- 左側のナビゲーション列でアクセストークンの生成をクリックします。
- アカウントのプライベートデータを操作する必要がある場合は、 認証済み (本人)を選択します。vimeo.comで一般公開されているメタデータの読み取りのみが必要な場合は、認証なしを選択します。
-
[認証済み] を選択した場合は、スコープの見出しの下で、トークンを付与する機能を確認します。詳細については、認証に関するドキュメントをご参照ください。
- アップロードするには一般公開、プライベート、編集 、アップロードのスコープが必要です。
- 直接ファイルリンクのメタデータを返すには、一般公開、プライベート、video_filesのスコープが必要です。
- 生成ボタンをクリックします。ページが再ロードされ、トークンがパーソナルアクセストークンのセクションに表示されます。
- トークン文字列をコピーして、安全な場所に保管してください。
このトークンは、VimeoAPIとやり取りするためにスクリプトかアプリで使用できます。トークンにアクセスできる人は誰でも、トークンを使用してあなたのアプリやアカウントに代わってリクエストを行うことができるため、必ずトークンは安全に保管してください。