入門
アカウント内の動画や再生リストの数、または過去1か月または1年に追加された動画の数を取得すると便利な場合があります。これらの種類のカウントは、/counts/
CMS APIのエンドポイント。
認証
へのリクエストCMS APIアクセストークンを含む認証ヘッダーが必要です。クライアントクレデンシャルを取得してアクセストークンを取得する方法の詳細については、「 Brightcove OAuth の概要」を参照してください。
ビデオカウントを取得する
動画の数を取得するには、GET
リクエスト先:
https://cms.api.brightcove.com/v1/accounts/{account_id}/counts/videos
レスポンスは次のようになります。
{
"count": 4999
}
ビデオカウントエンドポイントを非常に強力にしているのは、検索パラメータリクエストに。これにより、検索で返される動画の数を取得できます。検索パラメータは非常に柔軟であるため、これにより、次のような多くのことを数えることができます。
- カスタムフィールドに特定のタグまたは特定の値を持つ動画の数
- 昨年(または月、週など)に追加された動画の数
- 現在再生可能な動画の数
- 来週公開予定の動画数
プレイリスト数を取得する
アカウントのプレイリストの数を取得するには、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