尺寸：日期

尺寸：date

在本主題中，您將了解Analytics API日期維度。日期維度返回一天的分析數據。用戶可以指定from和to在參數yyyy-mm-dd格式。這使用戶可以查詢分析系統，以按天數生成報告。from和to日期範圍。使用者指定的任何日期範圍都會解譯為帳戶的目前時區。請求的日期範圍是包含性的，排除的，即如果用戶提出請求from=2013-09-24&to=2013-09-27，則響應將包含2013-09-24 00:00:00到2013-09-27 00:00:00的結果。

網址參數

分析 API 報表支援下列 URL 參數。

網址參數
參數	描述	必填	值	預設
`account`	您要報告的帳戶	是	一個或多個帳戶ID作為逗號分隔的列表	無
`dimensions`	要報告的維度	是	一個或多個維度作為逗號分隔列表（某些組合無效 - 使用此處的交互式工具確定組合是否有效）	無
`where`	用於指定報告的過濾器	否	{dimension}=={value} - 一個或多個以分號分隔的列表。該值將是該維度主要指標的一個或多個值。例如：`video==video_idcountry=country-code`、或`viewer=viewer_id`（在最後一種情況下，viewer_id 的形式將根據您是自己捕獲和發送某種 viewer_id，還是根據分析系統生成的值而有所不同）。	無
`limit`	退貨數量	否	正整數	+10
`offset`	要跳過的項目數	否	正整數	0
`sort`	用於排序項目的字段	否	請求返回的任何字段	video_view
`fields`	要返回的字段	否	根據您要報告的維度而變化	視頻，video_view
`format`	格式化以返回結果	否	json（默認）\|格式 \| xlxs	json
`reconciled`	如果包含，會將結果限制為歷史數據或實時數據。分析資料來自多個來源：有些是由播放程式傳送，但其他資料則是從 CDN 和 Video Cloud 系統收集。為了盡快提供分析，我們會在可用時立即開始提供「即時」資料，然後在收集和處理所有來源的資料後稍後調整分析。完全處理後的數據稱為已協調	否	真實\|假	真正
`from`	請求的日期範圍的開始	否	下列其中一項： ISO 8601 日期 (YYYY-MM-DD) 以毫秒為單位的紀元時間（例如：1659641316719 [= 2022 年 8 月 4 日星期四 7:28:36.719 PM GMT]）。請參閱大紀元時間轉換器。一個字符串：`from=alltime` +/-以天（d），週（w）或月（m）為單位的相對日期-例如：`from=-6m&to=%2B2w`（從 6 個月前到 2 週之後的時間段-請注意，+ 符號需要被 URI 編碼為`%2B`）參與端點或如果 reconciled=false，則只允許過去 32 天內的日期。	-30d
`to`	請求的日期範圍的結尾	否	下列其中一項： ISO 8601 日期 (YYYY-MM-DD) 以毫秒為單位的紀元時間（例如：1659641316719 [= 2022 年 8 月 4 日星期四 7:28:36.719 PM GMT]）。請參閱大紀元時間轉換器。一個字符串：`to=now` +/-以天（d），週（w）或月（m）為單位的相對日期-例如：`from=-6m&to=%2B2w`（從 6 個月前到 2 週之後的時間段-請注意，+ 符號需要被 URI 編碼為`%2B`）參與端點或如果 reconciled=false，則只允許過去 32 天內的日期。	現在

可用字段

可以為維度返回以下字段。

ad_mode_begin -玩家進入廣告模式的次數
ad_mode_complete -播放器完成廣告模式的次數
active_media -帳戶中有效影片的數量
bytes_delivered -傳送至用戶端電腦的播放器和相關媒體的位元組總數
daily_unique_viewers -平均每日獨特使用者
date -ISO 8601日期（YYYY-MM-DD）格式的日期
drm_bytes_packaged -封裝的 DRM 位元組數
engagement_score -影片的平均參與分數
licenses_served -提供的 DRM 授權數目
live_seconds_streamed -交付的即時串流秒數總數
play_request -要求播放視訊的總次數
play_rate -影片的平均播放率 (影片觀看次數除以曝光次數)
player_load -玩家載入的總數
video_engagement_1 -影片持續時間的 1% 點的總觀看次數
video_engagement_100 -100% 影片持續時間點的總觀看次數
video_engagement_25 -影片持續時間 25% 的總觀看次數
video_engagement_50 -影片持續時間 50% 的總觀看次數
video_engagement_75 -影片持續時間 75% 的總觀看次數
video_impression -影片載入玩家的總次數
video_percent_viewed -所有影片觀看次數的總觀看次數 (總和，而非平均數)
video_seconds_viewed -所有影片的總觀看秒數
video_view -影片播放開始的總次數

篩選值

用作過濾器時，尺寸可以縮小結果範圍。

過濾值：日期維度不用作過濾器。

組合尺寸

要查看此尺寸可以與哪些尺寸組合以及可用於組合的字段，請參見維度和字段。

索取範例

尺寸要求

    https： //analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=date

篩選要求

    不適用

示例響應

{
  “item_count”：31,
  “項目”： [
    {
      “日期”："2022-04-30",
      “video_view”：160
    }，
    {
      “日期”："2022-05-07",
      “video_view”：220
    }，
    {
      “日期”："2022-05-21",
      “video_view”：226
    }，
    {
      “日期”："2022-05-08",
      “video_view”：236
    }，
    {
      “日期”："2022-05-28",
      “video_view”：261
    }，
    {
      “日期”："2022-05-29",
      “video_view”：280
    }，
    {
      “日期”："2022-05-01",
      “video_view”：307
    }，
    {
      “日期”："2022-05-03",
      “video_view”：431
    }，
    {
      “日期”："2022-05-02",
      “video_view”：512
    }，
    {
      “日期”："2022-05-30",
      “video_view”：518
    }
  ]、
  “概括”： {
    “video_view”：+45117
  }
 }

尺寸：date