サポート サポート問い合わせ先 | システムステータス システムステータス

フォルダーの操作

このトピックでは、あなたにフォルダを追加する方法を学びます。 Video Cloud メディアライブラリを使用して、ビデオをフォルダに追加する CMS API.

概要

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

の資格情報を取得する 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"]

フォルダの作成

ここに新しいフォルダを作成するために必要な情報があります。

リクエスト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
      }

フォルダ idname (リクエスト本体で設定した名前)は重要です。 フォルダにビデオを追加する。 あなたが忘れても心配しないでください 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

ページの最終更新日:12年2020月XNUMX日