平台 API 已知問題

這是平台 API 已知問題的編譯。

分析 API

在視頻中請求視頻或播放器字段fields而不要求它們作為尺寸

如果您使用video 要么player 字段(例如video video_name player 要么player_name )返回的字段中,但不要將其包含在dimensions ,響應項目將包含與這些項目無關的值,應將其忽略。項目中的其他值將有效

因應措施:請勿在響應字段中包含視頻或播放器字段,除非您也將它們包含為dimensions

大量的“其他”結果device_manufacturer
在某些情況下,您可能會看到大量的「其他」結果的device_manufacturer欄位。當資料收集器無法辨識以分析資料user_agent傳遞給資料時,就會發生這種情況。我們已經確定了這個最常見的原因是由 Instagram 創建的自定義 user_agent 字符串,但可能還有其他人。

CMS 應用程式

在某些情況下,original_filename 損壞
在某些情況下,original_filename 視頻的字段已損壞,將不包含真實的文件名。
標籤不可包含逗號
如果您嘗試將標籤添加到包含逗號的視頻(例如“ SomeCo,Inc”),請求將失敗,並顯示“非法標籤”錯誤
排程視訊
由於Playback API和商品目錄最多可緩存視頻10-15分鐘,因此請求播放器預定在接下來的幾分鐘(最多20分鐘)內可用的視頻的播放器可能無法獲取可播放的視頻,直到緩存刷新為止。
has_digital_master

如果您使用此欄位來測試影片是否可以重新轉碼,分享的影片並不可靠,因為如果原始影片擁有主影片,但是聯盟帳戶仍然無法重新轉碼。

因應措施:如果視頻已共享到帳戶,則需要同時測試has_digital_master = true sharing.by_external_account = false 。範例程式碼:

var video={some_video_object}
if (video.sharing !== null) {
  if (video.sharing.by_external_account === false) {
    if (video.has_digital_master) {
    // video can be retranscoded
    }
  }
}
使用更新/ PATCH時,播放列表允許使用重複的參考ID
當您更新播放列表時reference_id使用CMS API(或媒體模塊,因為它使用相同的API請求),將允許另一個播放列表已使用的參考ID。