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 会自动生成由系统管理的报告。内容所有者无法修改或删除创建这些报告的作业。 |