使用文件夾

簡介

可以創建文件夾來組織視頻庫中的視頻。您可以選擇按主題，作者，產品，地區等組織視頻。將視頻保存在文件夾中可以更輕鬆地在包含數百或數千個視頻的帳戶中進行管理。

獲取證書 CMS API

要使用 CMS API 您將需要適當的憑據。

在大多數情況下，獲取憑據的最簡單方法是通過Studio Admin API身份驗證部分（需要您帳戶的管理員權限）。看到管理API身份驗證憑據有關詳細信息。在這種情況下，您需要的權限是視頻 -您需要讀寫權限：

如果您所需的權限在Studio中不可用，或者您希望直接從 OAuth API，請使用您的選擇 獲取客戶憑證 下面列出的文件。無論選擇哪個選項，都需要詢問正確的操作權限。以下內容可以與cURL或Postman一起使用以獲取適當的權限：

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

創建文件夾

這是創建新文件夾所需的信息。

要求網址

註冊一個 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