Analytics

CDN 使用量報告

（以下內容均翻譯自英文版文件，最新資訊及內容敬請切換至英文語系參考原文）

 

CDN 使用量報告提供以下詳細信息：

  • 內容資訊： 這包括內容的標題、內容 ID、流媒體類型和內容創建時間。
  • CDN 消耗日期： CDN 被消耗的日期。
  • CDN 使用量（GB）： 這是特定日期內消耗的 CDN 使用量。

以下示例為 2023 年 6 月期間 CDN 消耗量的 CSV 格式 CDN 報告：

生成 CDN 報告

您可以使用以下 API 以生成 CDN 報告：

GET /bv/analytics/v1/reports/cdn-usage

此 API 接受兩個查詢參數：

  • streaming_type: 指定要生成報告的內容類型:
    • CDN_REPORT_STREAMING_TYPE_LIVE 用於直播活動
    • CDN_REPORT_STREAMING_TYPE_VOD 用於 VOD
    • CDN_REPORT_STREAMING_TYPE_LIVE_TO_VOD 用於 live-to-VOD 回放
  • time: 使用 ISO 8601 格式指定報告的月份 (YYYY-MM-01T00:00:00Z). 報告將包括從指定月份第一天 00:00:00 到最後一天 23:59:59 期間的 CDN 消耗總量。

以下是一個 cURL 請求的示例 :

curl --request GET \
  --url 'https://api.one-dev.kkstream.io/bv/analytics/v1/reports/cdn-usage?time=2023-07-01T00%3A00%3A00Z&streaming_type=CDN_REPORT_STREAMING_TYPE_LIVE_TO_VOD' \
  --header 'Accept: application/json' \
  --header 'authorization: Bearer <your-api-token>' \
  --header 'x-bv-org-id: <your-organization-id>'

成功的回應將包含觀看時間報告的 URL：

{
  "url": "string"
}

現在，您可以通過導航至此 URL 來訪問您的報告。

 

註記：

  1. 如果報告不可用（目標月份後 1-2 天）或指定月份沒有消耗，API 將回應 404 錯誤。
  2. URL 會在一小時後過期。如果過期，請再次使用此 API 獲取新的 URL。

更新於