ReportTypes

reportType 資源可識別頻道或內容擁有者可擷取的特定報表。

方法

下表列出 API 支援 report 資源的方法。

方法
list 傳回頻道或內容擁有者可擷取的報表類型清單。

JSON 資源表示法

以下 JSON 結構顯示 reportType 資源的格式:

{
  "id": string,
  "name": string,
  "deprecateTime": timestamp,
  "systemManaged": boolean
}

屬性

下表定義此資源中顯示的屬性:

屬性
id string
YouTube 在識別報表時使用的 ID。屬性值的長度上限為 100 個字元。以下表格列出每種支援的報表類型 (最多 100 個字元) 的最新版本。

name string
報表名稱。屬性值的長度上限為 100 個字元。
deprecateTime timestamp
報表即將停用或即將淘汰的日期和時間。如果您的工作適用已淘汰的報表類型,YouTube 會在該日期宣布三個月後,針對該工作產生新報表。

舉例來說,content_owner_basic_a1 報表的淘汰公告是在 2016 年 5 月 19 日發布。因此,該報表類型的 deprecateTime 欄位會指定 2016 年 8 月 19 日的時間,之後 YouTube 就會停止產生該類型報表。
systemManaged boolean
如果 YouTube 內容擁有者沒有內容擁有者先呼叫 jobs.create 方法,指示 YouTube 產生報表,那麼這個值為 true。事實上,如果 reportTypeId 屬性識別出系統管理的報表,則 jobs.create 方法會傳回錯誤。