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 在该日期之后不再为作业生成新报告的日期。 如果您的作业确定了过期日期，您应更新系统，在该日期前停止请求报告。在某些情况下，系统可能会提供替换报告。
systemManaged	boolean 如果作业生成系统管理的报告，则此值为 true。YouTube 会自动为可以在 YouTube 创作者工作室中访问相同报告的 YouTube 内容所有者生成系统管理的报告。内容所有者无法修改或删除用于创建这些报告的作业。