本頁面由 Cloud Translation API 翻譯而成。

Jobs

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

方法

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

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

以下 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 世界標準時間「Zulu」的時間戳記格式，精確到微秒。範例：`"2015-10-02T15:01:23.045678Z"`。
`expireTime`	`timestamp` 工作過期或即將失效的日期和時間。屬性值是 RFC3339 世界標準時間「Zulu」的時間戳記格式，精確到微秒。示例：`"2015-10-02T15:01:23.045678Z"`。如果與工作相關聯的報表類型已淘汰，或是系統長時間未下載工作產生的報表，這個屬性就會傳回值。此值標示的是在該日期過後，YouTube 將不再為該工作產生新報告。如果您的工作認得到期日，則應更新系統，在該日期之前停止要求報告。在某些情況下，系統會提供替換報告。
`systemManaged`	`boolean` 如果工作產生系統代管報表，這個值為 `true`。YouTube 會自動為可存取 YouTube 創作者工作室報表的 YouTube 內容擁有者產生系統管理的報表。內容擁有者無法修改或刪除會建立這些報表的工作。