聯繫支持
系統狀態video 尺寸。 的 video 維度通過視頻提供分析。 注意：如果您希望包含任何“視頻”。 字段（例如 video.name）中，您的客戶憑據必須包含CMS：視頻讀取權限。 另請注意，雖然您無法返回 video.custom_fields，您可以返回 video.custom_fields.{field_name}.網址參數
Analytics API 報告支持以下URL參數。
| 參數 | 產品描述 | 需要的 | 價值 | 默認 |
|---|---|---|---|---|
account |
您要報告的帳戶 | 是 | 一個或多個帳戶ID作為逗號分隔的列表 | 沒有 |
dimensions |
要報告的維度 | 是 | 一或多個維度，以逗號分隔列表（某些組合無效） | 沒有 |
where |
用於指定報告的過濾器 | 沒有 | {dimension} == {value}-一個或多個作為用分號分隔的列表 | 沒有 |
limit |
退貨數量 | 沒有 | 正整數 | 10 |
offset |
要跳過的項目數 | 沒有 | 正整數 | 0 |
sort |
用於排序項目的字段 | 沒有 | 請求的有效字段 | video_view |
fields |
要返回的字段 | 沒有 | 根據您要報告的維度而變化 | video_view |
format |
格式化以返回結果 | 沒有 | json | csv | l | JSON |
reconciled |
如果包含，則將結果限制為歷史或實時數據 | 沒有 | 真實| 假 | 真 |
from |
請求的日期範圍的開始 | 沒有 | ISO 8601日期（YYYY-MM-DD），紀元時間（以毫秒為單位），字符串alltime或相對日期（-1m）； 參與度終結點僅允許使用過去32天內的日期，或者如果對帳=否，則只允許使用。 | 現在30天前 |
to |
請求的日期範圍的結尾 | 沒有 | ISO 8601日期（YYYY-MM-DD），紀元時間（以毫秒為單位），現在的字符串或相對數據（+ 7d）； 參與度終結點僅允許使用過去32天內的日期，或者如果對帳=否，則只允許使用。 | 現在 |
可用字段
可以為維度返回以下字段。
ad_mode_begin-的次數 player 進入廣告模式ad_mode_complete-的次數 player 完整的廣告模式bytes_delivered-發送給客戶端計算機的總字節數 player 及相關媒體engagement_score-視頻的參與度得分play_request-請求播放視頻的總次數play_rate-視頻的平均播放率（視頻觀看次數除以展示次數）video-視頻IDvideo_duration-視頻時長（如果已報告）video_engagement_1-視頻觀看次數的百分之一video_engagement_100-在視頻時長的100％處的觀看總數video_engagement_25-在視頻時長的25％處的觀看總數video_engagement_50-在視頻時長的50％處的觀看總數video_engagement_75-在視頻時長的75％時的觀看總數<video_impression-視頻加載到的總次數 playersvideo_name-時間範圍內最近一次展示時的視頻名稱video_percent_viewed-所有視頻觀看次數佔視頻觀看百分比。 例如，如果在此期間有兩個視圖，而在一個視圖中查看的百分比為78％，而在另一個視圖中為59％，則video_percent_viewed返回將是 137.video_seconds_viewed-每個視頻觀看的平均觀看秒數video_view-視頻播放開始的次數video.reference_id-視頻的參考IDvideo.name-視頻的當前名稱video.description-視頻的當前描述video.complete-視頻處理是否完成video.created_at-創建視頻的日期/時間video.duration-視頻的當前時長video.economics-是否為視頻啟用了廣告video.long_description-視頻的詳細說明video.state-該視頻當前是否ACTIVEorINACTIVEvideo.tags-視頻的標籤video.updated_at-上次修改視頻的日期/時間video.custom_fields.{field_name}-名為“”的視頻的自定義字段的值{field_name}video_download_request-已啟用離線播放的視頻的下載請求數video_download_complete-啟用離線播放的視頻被完全下載的次數video_download_cancellation-啟用離線播放的視頻的下載次數被取消（包括在下載完成之前關閉頁面的次數）video_download_error-由於發生錯誤，無法離線下載視頻的下載次數
篩選值
用作過濾器時，維可以縮小結果範圍。
過濾值：視頻ID（以逗號分隔的列表）或video.q == {視頻字段}：{值}
組合尺寸
要查看可以與之組合的尺寸，以及可以用於組合的字段，請參見 維度和字段.
索取範例
尺寸要求
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video
篩選要求
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=video==4093643993001,1754276206001
響應
Response will appear here when you test a request