System-Managed Reports - Fields

电影、音乐和电视

下表定义了 YouTube Reporting API 系统管理的电影、音乐和电视合作伙伴报告中显示的字段：

字段
active_claims 有效版权主张数量。
active_reference_id YouTube 为关联的有效参考文件生成的 ID。
activity_month 报告对应的月份。
adjustment_amount 调整后的收入金额（以本地货币表示）。
adjustment_type 指明该行代表的是正常收入数据，还是对之前报告的收入的调整：
  • 如果该行代表正常收入数据，则字段值为 None。此外，该行中的数据会报告与该报告关联的月份的数据。
  • 如果该行表示对之前报告数据进行的调整，则该字段包含下表中的某个值。在这种情况下，该行可能包含与报告关联的月份以外的其他月份的数据。例如，2016 年 11 月的报告可能包含适用于 2016 年 10 月或其他先前月份事件的调整项。

    可能的调整类型包括：
    • Backpay - 因缺少所有权而预扣的付款。
    • Conflict Resolution - 因所有权冲突而被扣留的款项。这也是一种补发款项。
    • Dispute Resolution - 与已解决的争议相关的付款，涉及在当月付款之前扣留的收入。
    • Dispute Conflict Resolution - 异议解决后，因所有权冲突而被扣留的补发款项。
    • Spam Adjustment - 与垃圾内容更正相关的付款。这是一项扣减，AdSense 会将其报告为 Invalid Activity - YouTube。
    • Revenue Correction - 与技术错误或数据更正相关的付款。此值可能是赠金或扣减金额。
administer_publish_rights 指明唱片公司是否管理出版权，即是否为词曲作者、作曲家、出版商或其他拥有作品版权的各方收取和管理版税。可能的值有 True 和 False。
adsense_earnings_month 要查询 AdSense 报告的收入月份。
album 录音所属的专辑。该值的长度上限为 255 字节。
approx_daily_views 资产的日均观看次数。
approx_daily_engaged_views 资产的每日互动观看次数（近似值）。
approximate_request_timestamp YouTube 收到为音乐人启用该频道的请求的大致最早日期。
artist 与报告行中标识的资产相关联的音乐人姓名。该值的长度上限为 255 字节。
artist_name 与音乐人官方频道 (OAC) 启用请求关联的原始音乐人名称。
asset_channel_id 拥有合作伙伴上传的视频（已通过资产 [asset_id] 提出了版权主张）的频道。该字段的值是唯一标识该频道的 YouTube 频道 ID。您可以使用 YouTube Data API 的 channels.list 方法检索有关该频道的其他数据。
asset_custom_id 用来明确标识某项资产的可选资产元数据字段，通常为内部代码。其他合作伙伴无法查看您的自定义 ID。
asset_id YouTube 资产 ID，用于唯一标识与该行中的数据相关联的资产。您可以使用 YouTube Content ID API 的 assets.list 方法检索有关资产的其他数据，也可以在 studio.youtube.com 的“资产”页面中查找资产。
asset_label 与资产关联的资产标签。
asset_labels 与相应资产关联的资产标签。资产标签可让您按自定义类别对资产进行分组。然后，您可以使用这些标签来搜索资产、更新资产组、为已添加标签的资产制作广告系列、过滤 YouTube 数据分析等。
asset_metadata_type 参考文件对应资产的类型，例如 Web 或 Movie。
asset_owners 参考文件对应的资产的当前所有者。在 1.1 及更高版本中，此列包含内容所有者显示名称（或外部 ID），而不是合作伙伴代码。
asset_policy_block 所有者政策为“Block”的地区。值为相应地区的两个字母的国家/地区代码。
asset_policy_id 所有者政策的唯一标识符。目前，此值仅在 API 中提供。此字段不会显示在工作室内容管理器中。
asset_policy_monetize 所有者政策是“Monetize”的地区。值为相应地区的两个字母的国家/地区代码。
asset_policy_track 所有者政策是“Track”的地区。值为相应地区的两个字母的国家/地区代码。
asset_title 资产的标题。
asset_type 素材资源的类型。可能的值包括：
  • Art Track：表示 YouTube 上没有优质音乐视频的录音曲目。
  • Composition：表示乐曲。乐曲具有 ISWC 和作者等元数据，这是唯一一种在每个地区可以有多个所有者的资产类型。可以嵌入到录音资产中。
  • Movie：表示故事片。电影具有 ISAN/EIDR 和导演等元数据。
  • Music Video：表示录音的官方音乐视频。音乐视频具有视频 ISRC、歌曲和音乐人等元数据。音乐视频资产中嵌入有录音资产。
  • Sound Recording：代表录音。录音有 ISRC、音乐人和专辑等元数据。录音中嵌有乐曲资产，从而可能会被嵌入到音乐视频资产中。
  • Television episode：表示电视节目中的一集。剧集具有剧季和剧集编号等元数据。
  • Web：表示 YouTube Originals 或其他资产类型未涵盖的其他类型的视频内容。
audio_royalties YouTube 音频层产生的已确认收入。以下列两种合作伙伴收入中的较高者为准：音频广告净收入中合作伙伴的音频份额收入以及根据音频每次播放带来的最低收入计算的合作伙伴收入。
audio_share 合作伙伴音频层播放次数与音频层总播放次数的比率。
campaign_id 与交易关联的促销活动的标识符。
category 视频的类型，如视频观看页面上所示。该值是 YouTube 视频类别 ID。您可以使用 YouTube Data API 的 videoCategories.list 方法检索视频类别 ID 与类别名称的映射。
channel_display_name 上传视频的频道的显示名称。
channel_id 与该行中的数据相关联的视频 (video_id) 所属的频道。该字段值为 YouTube 频道 ID，用于唯一标识频道。您可以使用 YouTube Data API 的 channels.list 方法检索有关该频道的其他数据。
channel_name 与该行中的数据相关联的 YouTube 频道的显示名称。
claiming_asset_type 版权主张所涉资产的类型。
claim_created_date 版权主张的创建日期。
claim_id YouTube 版权主张 ID，用于唯一标识与该行中的版权主张相关联的资产。您可以使用 YouTube Content ID API 的 claims.list 方法检索有关该资产的其他数据，也可以在 studio.youtube.com 的“版权主张”页面中查找该资产。
claim_origin 针对视频创建版权主张所用的方法。可能的字段值包括：
  • Audio Match
  • Audio Swap
  • Batch Tool
  • CMS_UPLOAD
  • Content ID API
  • Descriptive Search
  • External
  • GameID Match
  • Google Dev ID
  • Hashcode
  • Melody Match
  • SFTP Upload
  • Video Match
  • Web Search
  • Web Upload
  • YouTube Admin
claim_policy_block 适用的版权主张政策是“Block”的地区。值为两个字母的国家/地区代码。
claim_policy_id 适用政策的唯一标识符。目前，此值仅在 API 中提供。此字段不会显示在工作室内容管理器中。
claim_policy_monetize 适用的版权主张政策是“Monetize”的地区。值为两个字母的国家/地区代码。
claim_policy_track 适用的版权主张政策是“Track”的地区。值为两个字母的国家/地区代码。
claim_status 指定声明的状态。可能的值包括：
  • ACTIVE：版权主张有效。
  • APPEALED：上传者已针对被拒的版权主张异议提出申诉，该申诉正在等待合作伙伴审核。
  • DELAYED_TAKEDOWN：合作伙伴发出了延迟移除要求，该要求在生效前有 7 天的宽限期。
  • DISPUTED：上传者已对版权主张提出异议，异议正在等待合作伙伴审核。
  • INACTIVE：此版权主张无效。
  • PENDING：版权主张正在等待状态计算或处理。
  • POTENTIAL：该版权主张是等待合作伙伴审核的潜在版权主张。
  • REMOVAL_UNDER_REVIEW：该版权主张有正在审核中的相似性移除要求。
  • REMOVED：收到版权主张的视频因相似性移除要求而被移除。
  • TAKEDOWN_UNDER_REVIEW：该版权主张有一项版权内容移除要求正在审核中。
  • TAKENDOWN：收到版权主张的视频因版权内容移除政策而被移除。
claim_status_detail 版权主张状态的详细信息，例如 CLOSED_MANUALLY。
claim_type 指明版权主张是针对所主张内容的音频、视频还是音像部分。此字段的有效值为：
  • 音频
  • 音像
  • 图像
claim_quality 已声明版权的视频的来源。可能的字段值包括：
  • Partner-provided - 视频由 YouTube 合作伙伴上传。
  • Premium UGC - 视频由第三方上传，受版权保护的片段符合长度和比例要求，可被视为与合作伙伴提供的许可内容等同的内容，符合收益分成条件。
  • UGC - 视频是用户生成的内容，这意味着它是由第三方上传的，但不符合与合作伙伴提供的许可内容等同的要求，无法参与收益分成。

注意：在可从 YouTube 创作者工作室的“报告”菜单下载的报告中，此字段名为 Content Type。
claimed_by_another_owner 指明是否有其他内容所有者对该视频提出了有效的第一方或第三方版权主张。
claimed_by_this_owner 指明生成报告的内容所有者是否对视频拥有有效的第一方或第三方版权主张。
comments_allowed 指明是否为视频启用了评论功能。
comp_custom_id 合作伙伴为乐曲资产分配的自定义 ID。
comp_id 唯一标识乐曲资产的 YouTube 资产 ID。
comp_iswc 乐曲资产的国际标准音乐作品编码 (ISWC)。
comp_title 合辑资产的标题。
comp_writers 乐曲的作曲者列表。
composition_right_type 指定与版权主张关联的乐曲权利类型。此字段的有效值包括：
  • 机械
  • 性能
  • 同步
conflicting_country_code 与其他合作伙伴存在所有权冲突的地区的 ISO 国家/地区代码。
conflicting_owner 遇到所有权冲突问题的其他合作伙伴的 ID。
conflicting_owner_artist 冲突所有者的资产中的音乐人。
conflicting_owner_asset_title 存在冲突的所有者提供的资产标题。
conflicting_owner_isrc 存在冲突的所有者提供的资产 ISRC。
content_type 已声明版权的视频的来源。可能的值包括：
  • Partner-provided - 您上传到自己 YouTube 频道的视频。您在上传视频的同时对其主张版权，并应用相应的使用政策。针对合作伙伴上传的内容声明版权，就能启用获利选项、Content ID匹配和报告功能。
  • Premium UGC - 第三方上传的视频，其中包含受版权保护的片段，这些片段符合长度和比例要求，可被视为与合作伙伴提供的许可内容等同的内容。
  • UGC - 由第三方上传的视频，其中包含您拥有所有权的内容（通过 Content ID 匹配或手动版权主张确定）。与该版权主张关联的匹配政策决定了视频在 YouTube 上的播放位置和播放方式。
constituent_asset_id 资产在合并之前曾使用的 ID。
constituent_asset_ids 资产在合并之前曾使用的 ID。
contractual_minimum_partner_earnings_usd 合同规定的合作伙伴最低收入（以美元计）。
conversion_rate 应用于交易的汇率。
corrected_tax_withholding_rate 用于计算退税的更正后税款预扣率。
country 标识活动发生的国家/地区。
country_code 标识活动发生所在国家/地区的国家/地区代码。该值是 ISO 3166-1 alpha-2 国家/地区代码。
coupon_used 指明交易是否使用了促销优惠券。
created_date 素材资源的创建日期。
currency 表示该行所代表的货币。
currency_code 表示该行所代表的货币代码。
custom_id 您（元数据提供方）用来标识某项资产的唯一值。该值可以是你为资产创建的唯一 ID，也可以是标准标识符，例如 ISRC。该值的长度上限为 64 字节，可以包含字母数字字符、连字符 (-)、下划线 (_)、英文句点 (.)、@ 符号或正斜杠 (/)。
date 活动发生的日期。该值采用 YYYYMMDD 格式。
date_created 参考文件创建的日期和时间（以世界协调时间 [UTC] 为准）。
date_id 活动发生的日期。该值采用 YYYYMMDD 格式。
day 活动发生的日期。
director 与相应资产关联的导演。
directors 与相应资产关联的导演。
display_ads_enabled 指明是否在视频中展示第三方广告。
display_isrc 为资产显示的 ISRC。
dpid 发送音乐人官方频道 (OAC) 请求的 DDEX 消息发送者的 DDEX Party ID (DPID)。
earnings_usd 合作伙伴收入（美元）。
effective_policy 在内容所有者拥有所有权的地区，适用于该视频的使用政策。
eidr 分配给电影或电视剧集的娱乐业标识注册 (EIDR) ID。该值包含 EIDR 注册表的标准前缀，后跟一个正斜杠、一个 20 字符的十六进制字符串和一个字母数字 (0-9A-Z) 校验字符。
eidr_edit_id 资产的娱乐业标识注册 (EIDR) 剪辑级标识符。
eidr_title_id 资产的娱乐业标识注册 (EIDR) 影视内容级标识符。
embedding_allowed 指明视频是否可以嵌入到第三方网站中。
end_date 结束日期和时间。
engaged_views 支持广告功能的用户产生的感兴趣的观看总次数。
engaged_views_in_conflict 冲突内容的感兴趣的观看次数。
episode_number 与视频关联的剧集编号。
episode_title 电视节目或电影剧集的标题。
excluded_perc 参考文件中被排除的内容所占的百分比，具体根据排除片段的总数和总时长计算。
exclusions 参考文件中被排除的部分和排除类型（例如，参考文件雷同内容、人工排除的内容、无效片段）。 排除类型有以下几种：
  • O = 通过内容管理器人工排除
  • P = 通过 API 人工排除
  • I = 通过“内容传送”手动排除
  • C = 参考文件雷同
  • S = 无效细分
  • B = 永久排除
final_partner_earnings_usd 交易的最终合作伙伴收入（以美元为单位）。
grid 全球发行标识符，用于明确标识某项资产的可选元数据字段。该字段的值正好包含 18 个字母数字字符。
has_multiple_claims 指明视频是否收到多个版权主张。如果视频有一项版权主张，则值为 false；如果有多项版权主张，则值为 true。

注意：在可从 YouTube 创作者工作室的“报告”菜单下载的报告中，此字段名为 Multiple Claims?。
hfa 由 Harry Fox Agency (HFA) 签发的六位字符代码，用于唯一标识一首乐曲。
hfa_song_code 由 Harry Fox Agency (HFA) 签发的六位字符代码，用于唯一标识一首乐曲。
id 唯一标识录音资产的 YouTube 资产 ID。
inactive_reference_id YouTube 为关联的无效参考文件生成的 ID。
is_made_for_kids_effective_setting 视频的有效“面向儿童的内容”设置。
is_made_for_kids_modifiable 指示用户是否可以修改“面向儿童的内容”设置。
is_made_for_kids_user_selection 指明视频是否被用户指定为“面向儿童的内容”。
is_merged 表示资产的创建原因是否为资产合并。
is_shorts_eligible 指明视频是否符合 Shorts 的要求。
isrc 相关资产的国际标准音像制品编码 (ISRC)。该字段的值正好包含 12 个字母数字字符。
iswc 乐曲资产的国际标准音乐作品编码 (ISWC)。该字段的值正好包含 11 个字符，格式为 1 个字母 (T) 后跟 10 位数字。
label 发行录音的唱片公司。该值的长度上限为 255 字节。
lifetime_engaged_views_in_conflict 冲突内容的生命周期互动观看次数。
lifetime_views_in_conflict 存在冲突的内容的总观看次数。
length_sec 参考文件的时长（以秒为单位）。
local_currency 收入支付所用的本地货币类型。
longest_match 版权主张对应的最长匹配部分。
long_nonskippable_video_ads_enabled 已弃用：此字段已弃用，并且始终填充 No。之前用于指明是否可以在视频播放期间展示第三方较长的不可跳过广告。
match_policy 应用的资产匹配政策。
matching_duration 版权主张对应的总匹配时长。
metadata_origination 资产元数据的来源。
monetized_views YouTube Premium 订阅服务中归因于您的内容的纯音频和音像互动播放总次数。此值仅适用于音乐合作伙伴。
monetized_views_art_track_audio 在 YouTube Premium 订阅服务中，归因于您的内容的 Art Track 纯音频互动播放次数。此字段仅适用于音乐合作伙伴。
monetized_views_art_track_audio_visual 在 YouTube Premium 订阅服务中，归因于您的内容的 Art Track 音像互动播放次数。此字段仅适用于音乐合作伙伴。
monetized_views_audio YouTube Premium 订阅服务中归因于您的内容的纯音频互动播放总次数。该值是 monetized_views_art_track_audio、monetized_views_partner_owned_audio 和 monetized_views_ugc_audio 字段之和。此字段仅适用于音乐合作伙伴。
monetized_views_audio_visual YouTube Premium 订阅服务中归因于您的内容的音像互动播放总次数。该值是 monetized_views_art_track_audiovisual、monetized_views_partner_owned_audiovisual 和 monetized_views_ugc_audiovisual 字段的总和。此字段仅适用于音乐合作伙伴。
monetized_views_partner_owned_audio YouTube Premium 订阅服务中归因于您的内容的纯音频互动播放次数，针对合作伙伴提供的官方音乐视频内容。此字段仅适用于音乐合作伙伴。
monetized_views_partner_owned_audio_visual YouTube Premium 订阅服务中归因于您的内容的音像内容互动播放次数，针对合作伙伴提供的官方音乐视频内容。此字段仅适用于音乐合作伙伴。
monetized_views_total_sub_service YouTube Premium 订阅服务中，由 YouTube 音乐合作伙伴声明过版权的所有内容产生的纯音频和音像创收观看次数总和。此值仅适用于音乐合作伙伴。
monetized_views_ugc_audio YouTube Premium 订阅服务中归因于您的内容的用户生成内容 (UGC) 纯音频互动播放次数。UGC 是指用户上传的视频，在收益分成方面，这些视频与合作伙伴提供的许可内容不同。此字段仅适用于音乐合作伙伴。
monetized_views_ugc_audio_visual YouTube Premium 订阅服务中归因于您的内容的用户生成内容 (UGC) 的音像互动播放次数。UGC 是指用户上传的视频，在收益分成方面，这些视频与合作伙伴提供的许可内容不同。此字段仅适用于音乐合作伙伴。
monetized_views_ugc_master_audio_visual YouTube Premium 订阅服务中归因于您的内容的音像主录制内容互动播放总次数。此值仅适用于音乐合作伙伴。
monetized_views_ugc_cover_audio_visual 在 YouTube Premium 订阅服务中，归因于您的内容的用户生成翻唱视频互动播放总次数。此值仅适用于音乐合作伙伴。
monetized_views_ugc_cover_shared_audio_visual 在 YouTube Premium 订阅服务中，归因于您的内容且采用三方收益分成模式的用户自制翻唱视频的总互动观看次数。此值仅适用于音乐合作伙伴。
monetized_watchtime 归因于您的非 MV 的 YouTube Premium 订阅总观看时长（以秒为单位）。
month 活动发生的月份。
midrolls_enabled 指明是否可以为视频播放中贴片广告。中贴片广告是指在其他视频或活动期间展示的视频广告。例如，在长篇电影中，中贴片广告可能会间隔出现。中贴片广告仅适用于许可内容。
multiple_claims 指明视频是否收到多个版权主张。如果视频有一项版权主张，则值为 false；如果有多项版权主张，则值为 true。

注意：在可从 YouTube 创作者工作室的“报告”菜单下载的报告中，此字段名为 Multiple Claims?。
music_claim_type 指明版权主张是针对所主张内容的音频、视频还是音像部分。此字段的有效值包括：
  • 音频
  • 音像
  • 图像
music_share 每个国家/地区和每项优惠的音乐活动百分比。
name_of_title 付费视频点播 (TVOD) 内容的标题。
native_contractual_minimum_partner_earnings 合同规定的合作伙伴最低收入（以本地货币表示）。
native_final_partner_earnings 以合作伙伴本地币种表示的最终合作伙伴收入。
native_partner_currency 合作伙伴收款时所用的本地币种。
native_partner_earnings 合作伙伴收入（以合作伙伴币种表示）。
native_partner_earnings_using_tax_exclusive_retail_price 使用不含税的本地货币零售价计算得出的合作伙伴收入。
native_partner_funded_discounts 合作伙伴资助的折扣金额（以本地货币表示）。
native_refunds_and_chargebacks 以本地货币表示的退款和退单金额。
native_retail_currency 零售交易价格采用的币种。
native_retail_price 零售交易价格（以本地零售货币表示）。
native_tax_exclusive_retail_price 不含税的零售交易价格，以本地零售币种表示。
native_total_tax 以本地货币表示的税费总额。
net_partner_revenue 合作伙伴的净收入。
net_partner_revenue_post_revshare 应用收益分成比例后合作伙伴的净收入。
revshare_rate_type 应用于收入的收益分成费率类型。
nonskippable_video_ads_enabled 指明是否为视频播放第三方不可跳过广告。插播视频广告会在内容视频播放期间展示。
notes 表示在延期调整付款的情况下，来自上个月的付款。
number_of_evaluated_requests_in_sample 质量抽样中评估的音乐人官方频道 (OAC) 申请数量。
number_of_purchases 该图书的总购买次数。
number_of_refunds_and_chargebacks 图书的退款和退单总数。
oac_channel 音乐人官方频道 (OAC) 启用请求中提供的自有自营频道 ID。
oac_status 音乐人频道的最新音乐人官方频道 (OAC) 启用状态，例如“已启用”或“已停用”。
oac_status_rationale 音乐人官方频道 (OAC) 启用请求被拒或处于待处理状态的原因。
offweb_syndicatable 指明视频是否可以在浏览器之外显示。
overlay_ads_enabled 指明是否为视频播放重叠式广告。重叠式广告是在视频播放 10 秒后显示在视频上方的展示广告。
other_isrc 其他合作伙伴为该资产提供的 ISRC。
other_owners_claiming 对视频也拥有版权主张的其他内容所有者的名称。
other_ownership_origination 其他所有者的原始所有权来源。
owned_views 您拥有的内容获得的感兴趣观看次数，这些内容适用的政策是创收或跟踪。

YouTube 广告报告和 YouTube Premium 订阅报告（非音乐内容）都包含 policy 字段，该字段指明与数据关联的政策是monetize还是track。
owned_subscription_views YouTube Premium 订阅者对您拥有的内容（内容政策为“创收”或“跟踪”）的感兴趣观看总次数。
ownership 特定地区资产的所有者。
ownership_last_updated 上次更新所有权的日期和时间。
ownership_origination 原始所有权来源。
ownership_percentage 您占有的乐曲所有权百分比。
partner_audio_ad_revshare 根据账号的收入分配比率，按比例分成的 YouTube 音频层收入。用于计算两个收入数额中的较大值。
partner_audio_ad_revshare_rate 合作伙伴广告收益分成比例。
partner_earnings_fraction 用于计算合作伙伴收入的收益分成比例。
partner_earnings_usd 合作伙伴收入（美元）。
partner_earnings_using_tax_exclusive_retail_price_usd 合作伙伴收入（以美元计），根据不含税零售价计算得出。
partner_funded_discounts_usd 合作伙伴资助的折扣金额（美元）。
partner_name 合作伙伴的名称。
partner_playbacks YouTube 音频层服务中归因于您的内容的播放次数。
partner_reporting_id 合作伙伴提供的资产报告标识符。
partner_revenue 应用收益分成后，您获得的广告收入（以美元为单位）。此字段会显示在 YouTube 广告报告中。youtube_revenue_split 字段包含应用收益分成之前的总收入。
partner_revenue_art_track 按比例分成的 YouTube Premium 订阅收入；针对在音像模式下播放的 Art Track 内容。
partner_revenue_audio YouTube Premium 订阅收益分成；针对在纯音频模式下播放的内容。
partner_revenue_local 应用收益分成后，您通过广告获得的本地货币收入。此字段会显示在 YouTube 广告报告中。youtube_revenue_split 字段包含应用收益分成之前的总收入。
partner_revenue_usd 应用收益分成后，您获得的广告收入。此字段会显示在 YouTube 广告报告中。youtube_revenue_split 字段包含应用收益分成之前的总收入。
partner_revenue_auction 您通过竞价出售的 AdSense 广告获得的收入。
partner_revenue_per_play_min 根据每次播放带来的最低收入计算的收入。用于在国家/地区级别汇总时计算两个收入数额中的较大值。
partner_revenue_per_sub_min 根据每位订阅者产生的最低收入计算的每个国家/地区的收入；用于计算两个收入数额中的较大值。
partner_revenue_pro_rata 按比例分成的 YouTube Premium 订阅收入，考虑收益分成比例。
partner_revenue_pro_rata_audio 按比例分成的 YouTube Premium 订阅收入；针对在纯音频模式下播放的内容。
partner_revenue_pro_rata_audio_per_sub_min 按比例分成的 YouTube Premium 订阅收入；针对在纯音频模式下播放的内容。
partner_revenue_pro_rata_audio_visual 按比例分成的 YouTube Premium 订阅收入；针对在音像模式下播放的内容。
partner_revenue_pro_rata_partner_owned 按比例分成的 YouTube Premium 订阅收入；针对在音像模式下播放的合作伙伴上传的内容。
partner_revenue_pro_rata_ugc 按比例分成的 YouTube Premium 订阅收入；针对在音像模式下播放的用户生成的内容。
partner_revenue_pro_rata_art_track 按比例分成的 YouTube Premium 订阅收入；针对在音像模式下播放的 Art Track 内容。
partner_revenue_partner_sold_partner_served 您通过自己的外部广告服务器销售和投放的广告所带来的收入。
partner_revenue_partner_sold_youtube_served 通过 DFP 广告管理系统 (DFP) 销售广告所获得的收入，已应用收益分成。
partner_revenue_reserved 通过 DoubleClick (DCLK) 预订方式出售的广告和其他 YouTube 出售的广告资源带来的收入（已扣除收益分成）。
partner_revenue_ugc 您通过用户生成的内容获得的收入。
partner_status 合作伙伴的音乐人官方频道 (OAC) 质量评估状态。
payment_period 付款的时间段。
per_play_minimum 该特定国家/地区的每播放最低费率。
per_play_minimum_currency 音频每次播放最低收入的币种。
per_play_minimum_partner_revenue 根据每次播放带来的最低收入计算的收入。用于计算两个收入数额中的较大值。
per_sub_min_rate 根据每位订阅者产生的最低收入计算的每个国家/地区的收入；用于计算两个收入数额中的较大值。
per_subs_min_rate 该特定国家/地区的每位订阅者最低费率。
percentage_of_high_severity_bad_requests 样本中存在严重错误的音乐人官方频道 (OAC) 评估请求所占的百分比。
percentage_of_low_severity_bad_requests 样本中存在低严重性错误的音乐人官方频道 (OAC) 评估请求所占的百分比。
play_asset_id 与内容关联的 Google Play 资产 ID。
policy 应用于视频的政策。值为 monetize 或 track。
pool_participating_rate 动态池中所有参与合作伙伴的含广告 (AVOD) 市场份额（相对于基准主要合作伙伴）。
postrolls_enabled 指明是否可以为视频播放后贴片广告。后贴片广告会在观看者正在观看的视频或直播结束后播放。
prerolls_enabled 指明是否可以为视频播放前贴片广告。前贴片广告会在观看者正在观看的视频或直播之前播放。有时，系统会播放多个前贴片广告。
provider 提供参考文件的内容所有者的姓名/名称。
psaid 合作伙伴提供的音乐人 ID (PSAID)（在音乐人官方频道 [OAC] 请求中提供）。
purchase_location 发生购买交易的平台或途径。
purchase_type 付费功能购买交易的类型。
quantile 录音资产的观看次数分位数。
ratings_allowed 指明是否为视频启用了评分功能。
record_label 资产元数据中的唱片公司名称。仅适用于音乐合作伙伴。
reference_id YouTube 为与版权主张关联的参考文件生成的 ID。对于合作伙伴上传的版权主张，此字段将留空。
reference_type 参考类型或渠道，例如 Audio、Visual、AudioVisual。
reference_video_id YouTube 为参考文件生成的视频 ID。仅当版权主张与源自 YouTube 视频的参考文件相关联时适用。
refund_chargeback 指示相应交易行代表的是退款还是退单。
refunds_and_chargebacks_usd 退款和撤单的总金额（以美元计）。
release_date 资产元数据中的发布日期。仅适用于电视/电影合作伙伴。
report_date 报告的生成日期，采用人类可读的格式。
report_name 与渠道调整关联的来源报告的名称。
request_funnel 用于向 YouTube 提交音乐人官方频道 (OAC) 请求的渠道，例如 DDEX 或旧版。
resolution 交易的视频分辨率，例如 HD 或 SD。
retail_price_usd 零售交易价格（美元）。
revenue_source 指明收入来源。可能的值如下：
  • Ads - 视频中展示的广告带来的收入。
  • Subscriptions - YouTube Premium 付费订阅带来的收入。
  • Transactions - 交易所产生的收入，例如付费内容或购买交易。
revenue_type 指明该行所代表的收入类型。
right_type 指定与版权主张关联的乐曲权利类型。此字段的有效值包括：
  • 机械
  • 性能
  • 同步
season 与电视剧集关联的季数。此字段的最大长度为 5 字节。
season_title 与内容相关联的电视剧季的标题。
shorts_creations 使用该资产创作的 YouTube Shorts 短视频数量。
shorts_flat_fee_revenue_usd Shorts 的固定费用收入（以美元计）。
shorts_monthly_pool_usd Shorts 收益池的月收入（以美元计）。
shorts_partner_revenue_usd 合作伙伴通过 Shorts 获得的收入（美元）。
shorts_usages_marketshare Shorts 使用情况的市场份额。
show_title 与内容相关联的电视节目的标题。
skippable_video_ads_enabled 指明是否已为视频启用可跳过的视频广告。可跳过的插播广告在 YouTube 上以及 Google 视频合作伙伴的网站和应用中的其他视频播放前、播放过程中或播放后播放。广告播放 5 秒钟之后，观看者可以选择跳过广告，继续观看视频。
source_of_fingerprint 特定参考文件的指纹来源。
sponsored_cards_enabled 指明是否已为视频启用赞助商卡片。赞助商产品信息卡片可让观看者购买视频中展示的商品。
sr_approx_daily_engaged_views 录音的大致每日互动观看次数。
start_date 开始日期和时间。
status 表示资产的状态。可能的值为 active 或 inactive。
status_change 指示与相应事务相关联的任何状态更改。
status_detail 提供有关参考文件状态的其他详细信息或原因。此字段仅在每周参考文件报告的 1.1 版中提供。
studio 与资产相关联的工作室。
subscribers 订阅人数。
tax_exclusive_retail_price_usd 不含税的零售交易价格（以美元计）。
tax_refund_amount 以本地货币表示的退税金额。
tax_withholding_rate 税款预扣报告中适用的预扣税率。
tax_withheld_amount 税款预扣报告中的税款预扣金额。
territory 所有权或活动适用的地区。
third_party_ads_enabled 指明是否已为视频启用第三方广告。
third_party_video_id 合作伙伴提供的视频 ID，合作伙伴使用该 ID 来标识视频，以便进行广告定位。
time_published 视频在 YouTube 上的发布日期和时间，采用 MM/DD/YYYY HH:MM:SS 格式。对于从未公开过的视频（即私享视频或不公开列出的视频），此字段将留空。
time_uploaded 视频上传到 YouTube 的日期和时间，采用 MM/DD/YYYY HH:MM:SS 格式。
title 与报告行中的数据相关联的资产的标题。
title_name 付费视频点播 (TVOD) 内容的标题。
tms 由 12 到 14 个字符组成的 Tribune Media Systems (TMS) ID 值，用于唯一标识电影或电视剧集。
total_playbacks YouTube 音频层服务中的总播放次数。
total_revenue_by_source 按来源（例如广告或订阅收入）统计的总收入。
total_tax_usd 税费总额（美元）。
total_views 支持广告功能的用户产生的总观看次数。
transaction_date 交易发生的日期。
transaction_import_source 导入交易的源系统。
transaction_type 交易类型，例如租借或购买。
unix_report_micros 报告生成时的时间戳，以自 Unix 纪元以来的微秒数表示。
unlaunched_territories_adjustment 针对未推出 Shorts 服务的地区对 Shorts 收益池进行的调整。
upc 通用商品代码 (UPC)，用来明确标识某项资产的可选元数据字段。
upcs 包含音乐人官方频道 (OAC) 请求的发行作品的通用商品代码 (UPC) 列表（最多 10 个）。
uploader 上传视频的内容所有者的名称。
upload_source 将视频上传到 YouTube 所用的方法。
us_sourced_revenue 来自美国的收入金额。
usd_local_rate 美元兑换本地货币的汇率。该值表示整个报告期内每日交易的平均汇率。
username YouTube 内容所有者的名称。
vevo_enablement_status 通过 DDEX 提交的音乐人官方频道 (OAC) 申请的 Vevo 启用状态。
video_category 视频内容的类别。
video_channel_id YouTube 生成的频道标识符，其对应的频道发布了您主张版权的视频。
video_duration 视频的时长。
video_duration_sec 视频时长（以秒为单位）。
video_id 与行中数据相关联的已主张版权的视频。该字段值为 YouTube 视频 ID，用于唯一标识视频。您可以使用 YouTube Data API 的 videos.list 方法检索有关视频的其他数据。
video_length 视频时长（以秒为单位）。
video_matching_length 您主张版权的视频中的总匹配时长。
video_privacy_status 指明视频是公开、私享还是不公开列出。
video_title 与行中数据相关联的视频的标题。
video_upload_date 您主张版权的视频的上传日期。
video_url YouTube 视频的网址。
views 视频的观看次数。
writers 以竖线分隔的乐曲作者列表。
youtube_revenue_split

对于唱片公司、电影和电视合作伙伴：您的内容带来的 YouTube 广告总收入。然后，系统会根据收益分成比例对这笔金额进行分配。partner_revenue 字段包含您的收入。

对于音乐出版商：您的内容带来的 YouTube 广告总收入，已考虑资产所有权，但尚未根据收益分成比例进行分配。partner_revenue 字段包含您的收入。

youtube_revenue_split_auction

对于唱片公司、电影和电视合作伙伴：通过竞价出售的 AdSense 广告带来的总收入（应用收益分成前）。

对于音乐出版商：通过竞价售出的 AdSense 广告带来的总收入，已将资产所有权因素考虑在内，但尚未进行收益分成。

youtube_revenue_split_partner_sold_partner_served

对于唱片公司、电影和电视合作伙伴：由合作伙伴出售、合作伙伴投放的广告带来的总收入。然后，系统会根据收益分成比例对这笔金额进行分配。partner_revenue_partner_served_partner_sold 包含您从合作伙伴出售、合作伙伴投放的广告中获得的收入。

对于音乐出版商：根据合作伙伴出售计划销售并由合作伙伴投放的广告所带来的总收入，已将资产所有权因素考虑在内。随后，系统会根据收益分成比例对这笔金额进行分配。partner_revenue_partner_served_partner_sold 包含您从合作伙伴出售、合作伙伴投放的广告中获得的收入。

youtube_revenue_split_partner_sold_youtube_served

对于唱片公司、电影和电视合作伙伴：DFP 广告管理系统 (DFP) 的总收入。然后，系统会根据收益分成比例对这笔金额进行分配。partner_revenue_partner_served_partner_sold 包含您从合作伙伴出售、合作伙伴投放的广告中获得的收入。

对于音乐出版商：DFP 广告管理系统 (DFP) 的总收入，考虑了资产所有权。然后，系统会根据收益分成比例对这笔金额进行分配。partner_revenue_partner_sold_youtube_sold 包含您从合作伙伴出售、合作伙伴投放的广告中获得的收入。

youtube_revenue_split_reserved

对于唱片公司、电影和电视合作伙伴：通过 DoubleClick (DCLK) 预订方式出售的广告和其他 YouTube 出售的广告资源带来的总收入。然后，系统会根据收益分成比例对这笔金额进行分配。partner_revenue_reserved 包含您从这些来源获得的收入。

对于音乐出版商：通过 DoubleClick (DCLK) 预订方式出售的广告和其他 YouTube 出售的广告资源带来的总收入，其中考虑了资产所有权。然后，系统会根据收益分成比例对这笔金额进行分配。partner_revenue_reserved 包含您从这些来源获得的收入。
youtube_video_id 唯一标识视频的 YouTube 视频 ID。
your_isrc 您为资产提供的 ISRC。

Primetime

下表定义了 Primetime 节目合作伙伴的 YouTube Reporting API 系统管理报告中显示的字段：

字段
AgeGroup 报告中观看者的年龄段。请注意，特定年龄段的成员必须至少有 50 次观看事件，该年龄段才会列出。可能的字段值包括：
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
AverageViewDuration 所有观看事件中节目的平均观看秒数。
AverageViewPercent 所有观看事件中观看节目的平均百分比。
CallSign 如果适用，则标识节目播出电台的呼号。
ConcurrentViewers 在所有观看事件中，由 MinutesSinceStart 字段值标识的特定分钟数被观看的总次数。
ContentId 由您（元数据提供方）用来标识资产并已提供给 YouTube 的唯一值。您可以使用此值将资产与您自己的内容管理系统进行对账。 该值可以是你为资产创建的唯一 ID，也可以是标准标识符，例如 TMS ID。该值的长度上限为 64 字节，可以包含字母数字字符、连字符 (-)、下划线 (_)、英文句点 (.)、@ 符号 (@) 或正斜杠 (/)。
ContentLength 节目的时长（以秒为单位）。请注意，对于采用动态广告插播 (DAI) 技术的 VOD 节目，广告时长不包含在内。
ContentType 观看者观看内容的方式。可能的字段值包括：
  • DVR：观看者录制了该节目并将其保存到 DVR。
  • Live：观看者在节目首次直播期间观看了该节目。例如，观看者观看了体育赛事直播。
  • VOD：观看者选择了按需提供的剧集或节目。
Date 节目观看发生的日期。该值采用 YYYYMMDD 格式。
DeviceType 观看者观看内容时所用的设备类型。请注意，特定设备类型必须至少有 50 次观看事件，该设备类型才会列出。可能的字段值包括：
  • Computer
  • Console
  • Mobile Phone
  • Tablet
  • TV
DmaId Nielsen 用于标识与数据行中所述观看事件相关联的特定媒体市场区域 (DMA) 的 3 位数标识符。
EpisodeNumber 如果适用，则标识节目在指定剧季中的连续剧集编号。 季由 SeasonNumber 字段标识。例如，对于某节目的第二季第一集，此值将为 1。
Gender 报告中观看者的性别。请注意，特定性别的成员必须至少有 50 次观看事件，该性别才会列出。可能的字段值包括：
  • Male
  • Female
MinutesSinceStart 观看事件开始时，节目已播放的分钟数。请注意，此数字包括节目时间和广告时间，但使用动态广告插播 (DAI) 的点播 (VOD) 节目除外。对于采用 DAI 的 VOD 节目，该数字仅包含节目时长。
Network 发布或播放相应内容的电视台或影音平台。
PeakConcurrentViewers 特定节目在任意给定分钟内的并发观看事件数量上限。
Platform 观看者观看内容的方式。可能的字段值包括：
  • Android
  • iOS
  • TV HTML5
  • Web
ProgramTitle 剧集、影片或活动的标题或名称。
ProgramType 观看者观看的节目类型。可能的字段值包括：
  • PROGRAM_TYPE_UNKNOWN
  • PROGRAM_TYPE_MOVIE
  • PROGRAM_TYPE_EPISODE
  • PROGRAM_TYPE_COMPLEX_EPISODE
  • PROGRAM_TYPE_SPORTS
  • PROGRAM_TYPE_SPECIAL
  • PROGRAM_TYPE_EVENT
  • PROGRAM_TYPE_PAID_PROGRAMMING
PublishDateTime 节目的播出日期或发布日期。该值采用 YYYY-MM-DD 格式。
SeasonNumber 与该节目关联的季数。此字段的最大长度为 5 字节。
SeriesTitle 与报告行中的数据相关联的系列标题。例如，对于电视节目，此值将指定节目的名称，而 ProgramTitle 字段将指定剧集的标题。
TmsId 用于唯一标识节目的 12 到 14 个字符的 Tribune Media Systems (TMS) ID 值。
TotalWatchTime 在所有观看事件中，节目被观看的总时长（以秒为单位）。
ViewersComplete 直播、DVR 和 VOD 观看事件的总数，在这些事件中，观看者在特定分钟内停止观看视频，该分钟由 MinutesSinceStart 字段值标识。如果 MinutesSinceStart 值表示的值短于整个节目 (ContentLength)，则这些观看者在节目结束前停止了观看。
ViewersResume 观看者在视频前 1 分钟（第 0 分钟）以外的任何时间点开始观看 DVR 节目或 VOD 节目的观看事件总数。
ViewersStart 符合以下任一条件的观看事件总数：
  • 观看者在直播期间的任意一分钟加入了直播。
  • 观看者在 DVR 节目的第一分钟（第 0 分钟）内的任意时间点开始观看。
  • 观看者在 VOD 节目的第一分钟（第 0 分钟）内的任意时间点开始观看。
Views 在所有观看事件中，节目被观看的总次数。