簡介
視頻數據端點提供了一種獲取特定視頻的特定數據的快速方法。當前請求將返回該視頻的所有觀看時間。將來可能會返回其他數據。此終點的主要使用案例是將所有時間檢視資訊傳遞給高流量頁面上的玩家,在這種情況下,向中發出大量定期請求的速度Analytics API會太慢。
端點
視頻數據請求的端點是:
https://analytics.api.brightcove.com/v1/alltime/accounts/{account_id}/videos/{video_id}
所有請求均為GET。
驗證
所有對此的要求Analytics API都會透過 Brightcove 的 OAuth 服務進行驗證。
身份驗證基於在Authorization標頭中傳遞的訪問令牌:
Authorization: Bearer {your token}
您可以獲得客戶端憑據Analytics API並使用它們來檢索臨時訪問令牌 - 請參閱OAuth 概述有關可用於獲取客戶端憑據和訪問令牌的不同方法的說明,以及管理 API 憑據有關通過 Studio 獲取客戶端憑據的信息
響應
對請求的響應將是JSON,格式為:
{
"alltime_video_views": 103123
}
可能的實施
當視頻加載到播放器中時,可以使用以下方法使用視頻數據終結點來顯示視頻的全時視圖:
- 設置緩存以按視頻ID存儲5-10分鐘的觀看次數。
- 在服務器或頁面上創建邏輯,以首先檢查緩存以查看是否有全時視頻觀看當前視頻的數據,如果有,請使用它。
- 如果該值尚未緩存,請請求視頻信息端點以將其檢索,並將該值存儲在緩存中以及在頁面中顯示該值。
- 確保設置異常處理,以防對視頻信息端點的請求超時或不成功-您可能根本不顯示所有時間的視頻觀看次數,或者可能使用擁有的最後一個值。