取得影片和播放清單的計數

本主題介紹如何使用CMS API獲取帳戶中視頻或播放列表的數量。

簡介

有時,獲取帳戶中的視頻或播放列表數量,或者在過去一個月或一年中添加了多少個視頻有時很有用。您可以使用/counts/ CMS API的端點。

驗證

要求CMS API需要包含您的訪問令牌的授權標頭。如需有關如何取得用戶端認證並使用它們來擷取存取權杖的詳細資訊,請參閱 Brightcove OAuth 概觀

獲取視頻計數

要獲取視頻數量,請製作一個GET請求:

    https://cms.api.brightcove.com/v1/accounts/{account_id}/counts/videos

響應將如下所示:

    {
      "count": 4999
    }

使視頻計數終結點如此強大的原因是,您還可以附加一個搜索參數的要求。這樣一來,您就可以算出搜索返回的所有視頻。由於search參數非常靈活,因此您可以計算很多東西,例如:

  • 自定義字段具有特定標籤或特定值的視頻的數量
  • 去年(或每月或每周等)添加的視頻數量
  • 當前可播放的視頻數量
  • 下週計劃發行的視頻數量

獲取播放列表數

您還可以通過創建一個GET請求:

    https://cms.api.brightcove.com/v1/accounts/{account_id}/counts/playlists

響應的格式與視頻計數的格式相同。

您也可以在播放列表計數請求中使用搜索參數。因此,例如,您可以通過添加以下內容來找出帳戶中有多少個手動播放列表q=type:EXPLICIT的要求。

此外,通過將GET請求發送至以下位置,您可以獲取任何手動或智能播放列表中的視頻計數:

    https://cms.api.brightcove.com/v1/accounts/{account_id}/counts/playlists/playlist_id/videos