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