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)（即“祖鲁时”）格式的时间戳，精确到微秒。示例："2015-10-02T15:01:23.045678Z"。
expireTime timestamp
职位过期或到期的日期和时间。属性值是一个采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，精确到微秒。示例："2015-10-02T15:01:23.045678Z".

如果与相应作业关联的报表类型已被弃用，或为该作业生成的报表有很长时间未下载，该属性将提供一个值。此值标记了 YouTube 不再生成该职位相关报告的新日期。

如果您有已确定失效日期的任务，则应在此日期之后更新系统，让 Google 不再要求报告。在某些情况下，系统可能会提供替代报告。
systemManaged boolean
如果作业生成系统管理的报告，则此值为 true。YouTube 会自动为有权访问创作者工作室中相同报告的 YouTube 内容所有者生成系统管理的报告。内容所有者无法修改或删除创建这些报告的作业。