ReportTypes

reportType 资源用于标识频道或内容所有者可以检索的特定报告。

方法

下表显示了该 API 支持 report 资源的方法。

方法
list 返回可供频道或内容所有者检索的报告类型列表。

JSON 资源表示法

下面的 JSON 结构显示了 reportType 资源的格式:

{
  "id": string,
  "name": string,
  "deprecateTime": timestamp,
  "systemManaged": boolean
}

属性

下表定义了此资源中显示的属性:

属性
id string
YouTube 用于唯一标识报告的 ID。属性值的长度上限为 100 个字符。下表列出了每种支持的报告类型的最新版本(最多 100 个字符)。

name string
报告的名称。属性值的长度上限为 100 个字符。
deprecateTime timestamp
报告过去或未来弃用的日期和时间。如果您拥有已弃用的报告类型的某个作业,YouTube 会在该作业公布弃用日期后的三个月内为该作业生成新报告。

例如,content_owner_basic_a1 报告的弃用公告于 2016 年 5 月 19 日生成。因此,该类型的报表的 deprecateTime 字段会指定 2016 年 8 月 19 日的时间,随后 YouTube 将停止生成该类型的报表。
systemManaged boolean
如果 YouTube 为内容所有者自动生成报告,而无需先调用 jobs.create 方法指示 YouTube 生成报告,则此值为 true。事实上,如果 reportTypeId 属性标识由系统管理的报表,则 jobs.create 方法会返回错误。