サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    フォルダの操作

    このトピックでは、CMS API を使用してフォルダーを Video Cloud メディアライブラリに追加する方法と、ビデオをフォルダーに追加する方法について説明します。

    はじめに

    ビデオライブラリ内のビデオを整理するために使用するフォルダを作成できます。件名、著者、製品、地域など別に動画を整理することができます。フォルダーに動画があると、数百または数千の動画があるアカウントで管理しやすくなります。

    CMS API の認証情報を取得する

    CMS APIを使用するには、適切な資格情報が必要です。

    ほとんどの場合、資格情報を取得する最も簡単な方法は、Studioの管理API認証セクションを使用することです(アカウントに対する管理者権限が必要です)。詳細については、「 API 認証資格情報の管理」を参照してください。この場合、必要な権限はビデオ -読み取りと書き込みの両方の権限が必要です。

    リレーションシップのアクセス許可の共有
    リレーションシップのアクセス許可の共有

    必要な権限が Studio で使用できない場合、または OAuth API から直接取得する場合は、以下に示す [ クライアント認証情報の取得 ] ドキュメントを選択します。どちらのオプションを選択しても、正しい操作権限を要求する必要があります。cURL または Postman で次のものを使用すると、適切な権限を取得できます。

               "operations": [
               "video-cloud/videos/read",
               "video-cloud/videos/create",
               "video-cloud/videos/update"]

    フォルダーを作成する

    新しいフォルダを作成するために必要な情報は次のとおりです。

    URL をリクエスト

    作るPOSTリクエスト先:

          https://cms.api.brightcove.com/v1/accounts/account_id/folders

    リクエスト本文

          {
            "name": folder_name
          }

    応答

    レスポンスは次のようになります。

          {
            "id": "5a183efb10ab344b53775441",
            "account_id": "57838016001",
            "created_at": "2017-11-24T15:47:07.867Z",
            "name": "places",
            "updated_at": "2017-11-24T15:47:07.867Z",
            "video_count": 0
          }

    フォルダidそしてname(リクエスト本文に設定した名前)は重要です。両方が必要になるためです。フォルダにビデオを追加します。忘れても心配しないでくださいidただし、次の方法でいつでもこの情報を再度取得できるためです。フォルダを取得するアカウント用。

    フォルダを取得する

    アカウントのフォルダの配列を取得するには、GETリクエスト先:

          https://cms.api.brightcove.com/v1/accounts/account_id/folders

    レスポンスは次のようになります。

          [
            {
              "id": "5a17275782aca45b631295f9",
              "account_id": "57838016001",
              "created_at": "2017-11-23T19:53:59.687Z",
              "name": "birds",
              "updated_at": "2017-11-23T20:06:24.537Z",
              "video_count": 1
            },
            {
              "id": "560039e5e4b0e69e4b01cacd",
              "account_id": "57838016001",
              "created_at": "2015-09-21T17:09:57.260Z",
              "name": "fish",
              "updated_at": "2017-11-02T19:03:40.751Z",
              "video_count": 4
            },
            {
              "id": "5a183efb10ab344b53775441",
              "account_id": "57838016001",
              "created_at": "2017-11-24T15:47:07.867Z",
              "name": "places",
              "updated_at": "2017-11-24T15:47:07.867Z",
              "video_count": 0
            },
            {
              "id": "560039f1e4b0e69e4b01cad3",
              "account_id": "57838016001",
              "created_at": "2015-09-21T17:10:09.422Z",
              "name": "water",
              "updated_at": "2015-09-21T17:22:52.935Z",
              "video_count": 7
            }
          ]

    フォルダにビデオを追加する

    ビデオをフォルダに追加するには、PUTリクエスト先:

          https://cms.api.brightcove.com/v1/accounts/account_id/folders/folder_id/videos/video_id

    リクエスト本文

    この操作のリクエストボディはありません。

    応答

    このリクエストへの応答は204 NO CONTENT

    フォルダからビデオを削除します

    フォルダから動画を削除するには、DELETE動画の追加に使用するのと同じURLにリクエストします。

          https://cms.api.brightcove.com/v1/accounts/account_id/folders/folder_id/videos/video_id

    リクエスト本文

    このリクエストでは、リクエストの本文にフォルダ名も含める必要があります。

          {
            "name": folder_name
          }

    フォルダ内のビデオを取得する

    フォルダ内のビデオを取得するには、GETリクエスト先:

          https://cms.api.brightcove.com/v1/accounts/:account_id/folders/folder_id/videos

    リクエストパラメータ

    デフォルトでは、このリクエストは、フォルダに最後に追加された20本の動画を返します。これらのパラメーターの一方または両方をリクエストに追加することで、これを変更し、多くのビデオを含むフォルダーの結果をページングできます。

    • limit:返される動画の数(デフォルト:20、最大:100)
    • offset:スキップするビデオの数(デフォルト:0)

    たとえば、このリクエストは、考えられる結果の動画21〜30を返します(フォルダにその数の動画が含まれていると仮定します)。

          https://cms.api.brightcove.com/v1/accounts/:account_id/folders/folder_id/videos?limit=10&offset=20