ReportTypes

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

方法

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

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

JSON 资源表示法

以下 JSON 结构显示了 reportType 资源的格式：

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

属性

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

属性
id	string YouTube 用于唯一标识报告的 ID。属性值的最大长度为 100 个字符。下表列出了每种受支持的报告类型的最新版本（最多 100 个字符）。 查看频道支持的报告 报告 ID 说明 channel_basic_a2 用户活动 channel_province_a2 用户活动（按省份） channel_playback_location_a2 播放位置 channel_traffic_source_a2 流量来源 channel_device_os_a2 设备和操作系统 channel_demographics_a1 受众特征 channel_sharing_service_a1 分享服务 channel_annotations_a1 注释 channel_cards_a1 卡片 channel_end_screens_a1 片尾画面 channel_subtitles_a2 字幕 channel_combined_a2 合并 audience_retention_a1 视频的观众黏度 playlist_basic_a1 播放列表用户活动 playlist_province_a1 播放列表用户活动（按省份） playlist_playback_location_a1 播放列表播放位置 playlist_traffic_source_a1 播放列表流量来源 playlist_device_os_a1 播放列表设备和操作系统 playlist_combined_a1 合并播放列表 查看面向内容所有者的支持报告 报告 ID 说明 content_owner_basic_a3 用户活动 content_owner_province_a2 用户活动（按省份） content_owner_playback_location_a2 播放位置 content_owner_traffic_source_a2 流量来源 content_owner_device_os_a2 设备和操作系统 content_owner_demographics_a1 受众特征 content_owner_sharing_service_a1 分享服务 content_owner_annotations_a1 注释 content_owner_cards_a1 卡片 content_owner_end_screens_a1 片尾画面 content_owner_subtitles_a2 字幕 content_owner_combined_a2 合并 content_owner_playlist_basic_a1 播放列表用户活动 content_owner_playlist_province_a1 播放列表用户活动（按省份） content_owner_playlist_playback_location_a1 播放列表播放位置 content_owner_playlist_traffic_source_a1 播放列表流量来源 content_owner_playlist_device_os_a1 播放列表设备和操作系统 content_owner_playlist_combined_a1 合并播放列表 content_owner_ad_rates_a1 广告效果 content_owner_estimated_revenue_a1 按视频估算的收入 content_owner_asset_estimated_revenue_a1 按资产划分的估算收入 content_owner_asset_basic_a2 素材资源的用户活动 content_owner_asset_province_a2 资产的用户活动（按省份） content_owner_asset_playback_location_a2 资产播放位置 content_owner_asset_traffic_source_a2 素材资源的流量来源 content_owner_asset_device_os_a2 资产设备和操作系统 content_owner_asset_demographics_a1 资源受众特征 content_owner_asset_sharing_service_a1 素材资源分享服务 content_owner_asset_annotations_a1 资产注释 content_owner_asset_cards_a1 资产卡片 content_owner_asset_end_screens_a1 在片尾画面中展示素材资源 content_owner_asset_combined_a2 素材资源组合 查看支持的系统管理的报告（针对内容所有者） 报告 ID 说明 content_owner_ad_revenue_raw_a1 每个视频的精细广告收入 content_owner_ad_revenue_summary_a1 每个视频的广告收入汇总 content_owner_asset_ad_revenue_raw_a1 每个资产的精细广告收入 content_owner_asset_ad_revenue_summary_a1 每个资产的广告收入汇总 content_owner_claim_ad_revenue_summary_a1 版权主张（此报告不包含收入数据）
name	string 报告的名称。属性值的最大长度为 100 个字符。
deprecateTime	timestamp 报告被弃用或将被弃用的日期和时间。如果您有针对已弃用的报告类型的作业，YouTube 会在该弃用日期公布后的三个月内为该作业生成新报告。 例如，content_owner_basic_a1 报告的弃用公告发布于 2016 年 5 月 19 日。因此，相应报告类型的 deprecateTime 字段指定了 2016 年 8 月 19 日的某个时间，在此时间之后，YouTube 将停止生成相应类型的报告。
systemManaged	boolean 如果 YouTube 自动为 YouTube 内容所有者生成报告，而无需内容所有者先调用 jobs.create 方法来指示 YouTube 生成报告，则此值为 true。事实上，如果 reportTypeId 属性标识的是系统管理的报告，jobs.create 方法会返回错误。