Jobs

job 資源代表已排定的報表工作。檢舉工作可識別 YouTube 每天為特定頻道或內容擁有者產生的特定報表。

方法

下表列出 API 針對 job 資源支援的方法。

方法
create	建立報表工作。建立報表工作，即代表您指示 YouTube 每天產生報表。報表在工作建立後的 24 小時內即可使用。
delete	刪除報表工作。
get	針對頻道或內容擁有者已排定執行的特定報表工作，擷取相關資訊。
list	列出頻道或內容擁有者已排定的報表工作。回應中的每項資源都包含 id 屬性，該屬性會指定 YouTube 用來識別該工作的專屬 ID。您必須使用這個 ID，才能擷取為工作產生的報表清單，或是刪除工作。

JSON 資源表示法

以下 JSON 結構顯示 job 資源的格式：

{
  "id": string,
  "reportTypeId": string,
  "name": string,
  "createTime": timestamp,
  "expireTime": timestamp,
  "systemManaged": boolean
}

屬性

下表列出顯示在這項資源中的屬性：

屬性
id	string YouTube 用來識別報表工作的專屬 ID。值的長度上限為 40 個字元。
reportTypeId	string 工作建立的報表類型。屬性值會對應至從 reportTypes.list 方法擷取的 reportType id 的 id。
name	string YouTube 產生用來描述工作的名稱。值的長度上限為 100 個字元。
createTime	timestamp 工作的建立日期和時間。屬性值是採用 RFC3339 UTC Zulu 格式的時間戳記，精確度達毫秒。範例："2015-10-02T15:01:23.045678Z"。
expireTime	timestamp 工作過期或到期的日期和時間。屬性值是採用 RFC3339 UTC Zulu 格式的時間戳記，精確度達毫秒。例如："2015-10-02T15:01:23.045678Z"。 如果與此工作相關的報表類型已不適用，或長時間未下載該工作產生的報表，這項屬性就會顯示值。這個值會標示 YouTube 停止產生該項工作新報表的日期。 如果您的工作會指明到期日，請更新系統，以停止索取報表。在某些情況下，系統可能會提供替代報告。
systemManaged	boolean 如果工作產生系統代管報表，這個值會是 true。YouTube 會自動為能存取 YouTube 創作者工作室相同報表的 YouTube 內容擁有者產生系統管理的報表。內容擁有者無法修改或刪除建立這些報表的工作。