入門
ビデオライブラリ内のビデオを整理するために使用するフォルダを作成できます。件名、著者、製品、地域など別に動画を整理することができます。フォルダーに動画があると、数百または数千の動画があるアカウントで管理しやすくなります。
CMS API の認証情報を取得する
を使用するにはCMS API適切な資格情報が必要になります。
ほとんどの場合、資格情報を取得する最も簡単な方法は、Studioの管理API認証セクションを使用することです（アカウントに対する管理者権限が必要です）。詳細については、「 API 認証資格情報の管理」を参照してください。この場合、必要な権限はビデオ -読み取りと書き込みの両方の権限が必要です。
必要な権限が Studio で使用できない場合、または OAuth API から直接取得する場合は、以下に示す [ クライアント認証情報の取得 ] ドキュメントを選択します。どちらのオプションを選択しても、正しい操作権限を要求する必要があります。cURL または Postman で次のものを使用すると、適切な権限を取得できます。
フォルダーを作成する
新しいフォルダを作成するために必要な情報は次のとおりです。
URL をリクエスト
作るPOSTリクエスト先：
リクエスト本文
応答
レスポンスは次のようになります。
フォルダidそしてname（リクエスト本文に設定した名前）は重要です。両方が必要になるためです。フォルダにビデオを追加します。忘れても心配しないでくださいidただし、次の方法でいつでもこの情報を再度取得できるためです。フォルダを取得するアカウント用。
フォルダを取得する
アカウントのフォルダの配列を取得するには、GETリクエスト先：
レスポンスは次のようになります。
フォルダにビデオを追加する
ビデオをフォルダに追加するには、PUTリクエスト先：
リクエスト本文
この操作のリクエストボディはありません。
応答
このリクエストへの応答は204 NO CONTENT。
フォルダからビデオを削除します
フォルダから動画を削除するには、DELETE動画の追加に使用するのと同じURLにリクエストします。
リクエスト本文
このリクエストでは、リクエストの本文にフォルダ名も含める必要があります。
フォルダ内のビデオを取得する
フォルダ内のビデオを取得するには、GETリクエスト先：
リクエストパラメータ
制限とオフセット
デフォルトでは、このリクエストは、フォルダに最後に追加された20本の動画を返します。これらのパラメーターの一方または両方をリクエストに追加することで、これを変更し、多くのビデオを含むフォルダーの結果をページングできます。
limit：返される動画の数（デフォルト：20、最大：100）offset：スキップするビデオの数（デフォルト：0）
たとえば、このリクエストは、考えられる結果の動画21〜30を返します（フォルダにその数の動画が含まれていると仮定します）。
選別
を使用して返されたビデオを並べ替えることもできます選別パラメータ、これらのフィールドのいずれかに等しく設定します。
- name
- reference_id
- updated_at
- created_at
- published_at
- schedule_starts_at
- schedule_ends_at
- state
- Plays_total
- Plays_trailing_week
降順で並べ替えるには、フィールド値の前にマイナスのサイズ（ -created_at）。
のデフォルト値選別は-updated_at。