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 方法中检索到的 reportTypeidid
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 不再为任务生成新报告的日期。

如果您的任务指定过期日期,您应在该日期之前更新系统以停止请求报告。在某些情况下,我们可能会提供替换报告。
systemManaged boolean
如果作业生成系统管理的报告,则此值为 true。对于在 YouTube 创作者工作室中访问相同报告的 YouTube 内容所有者,YouTube 会自动生成由系统管理的报告。内容所有者无法修改或删除创建这些报告的作业。