Actor 是托管的数据采集程序。Task 是保存的输入预设。首次使用 YouTube Metrics build 1.1.2 工具直接检查视频时，请将 `startUrls` 中默认的 3 个示例视频全部替换为你打算检查的那 1 个已知视频的 URL，并将 `maxItems` 设为 1。不要输入整个频道，因为这会不当地暗示可以获取完整的上传历史。
原生输出字段包括 `inputUrl`、`postId`、`postUrl`、`postType`、`isShort`、`publishedAt`、`channelId`、`channelUrl`、`views`、`postMetricStatus`、`status` 和 `scrapedAt`。原生的 `postMetricStatus` 字段是一个对象数组，每个对象包含 `metric`、`value`、`status` 和 `precision` 属性，而不是对象映射；可用性与精度仍是不同的概念，缺失值仍表示未知，而不是零。
`OUTPUT` 中的采集汇总包括 `providedUrls`、`videoUrls`、`inputUrls`、`resolvedUrls`、`metricRows`、`datasetRows`、`noPublicMetricRows`、`blockedRows`、`failedRows` 和 `statusCounts`。实际核查过的对照运行使用了 2 个已知输入，返回的 `resolvedUrls` 为 2、`metricRows` 为 2、`datasetRows` 为 2，`statusCounts` 为 `{"ok": 2}`，而 `blockedRows`、`failedRows` 和 `noPublicMetricRows` 均为零。这证明了可以针对这些输入提取公开元数据和当前计数，并不保证每次检查都会返回 2 行，也不证明可以获取非公开的 Studio 分析数据、去重观看人数、观看时长、受众重叠情况，或历史上发布后相同时点的计数。此外，通过 `/shorts/` 路径访问的较早视频，实际上可能是标准长视频；路径名称或未经核查的原生标志都不能证明内容的实际形式。
界定参照总体
- 采集数字之前，先界定参照总体：在收集表现指标之前，明确说明你打算比较的具体视频群体，以防止选择偏差。
- 选定一个明确的分析单位和结果指标：将单个视频的累计观看次数与频道总计数区分开来。公开数据快照不会显示非公开的展示次数、观看时长或流量来源。选择一个范围明确、可以观测的问题，例如比较某个规定发布时长区间内的特定类型视频。
- 事先声明匹配因素和纳入规则：在查看计数之前，写下关于题材、经人工核查的视频形式、上传后时长区间、观测边界和自述频道阶段的规则。订阅人数和频道创建日期不能证明创作者的经验具有可比性。
- 根据核查过的公开证据收集候选视频：使用已知的直接 URL 整理候选列表。关于开始制作某个系列的带日期公开声明，只能支持 `claimed_stage` 因素，不能证明已核实的经验。如果缺少某个必需因素的证据，请将该候选视频标记为 `unresolved_factor_evidence`，不要将其归入某个类别。
- 采集原生观测数据，并保留原有精度：保留 `postId`、`channelId`、发布日期、观测时间、观看次数和精度状态。如果 `publishedAt` 只有日期标签，不要将其转换为精确时间戳。当前累计计数无法还原历史上发布后第 7 天的观看次数。
- 建立匹配情况与支持依据表：以目标视频为基准评估候选视频。将状态记录为 `eligible`、`excluded_factor_mismatch` 或 `unresolved_factor_evidence`，并明确注明任何不符合要求的因素。看到候选视频的观看次数后，不要放宽匹配规则，除非记录新的方案及其理由。
- 确定比较时间：判断能否立即比较、在大致相同的发布时长区间内比较，或在未来按计划采集数据后比较。不要用累计观看次数除以发布后的总时长，来补填缺失的历史第 7 天观看次数。如果不存在匹配的比较单元，就报告无法比较的结果。
- 列出有依据和无依据的比较单元：呈现已界定的参照总体、规则、证据及有依据的比较单元。少量选定的同类视频只能构成范围有限的参照，不能作为行业正常表现的基准。不要套用中位数或异常值公式，不要制作面向赞助商的媒体资料包，也不要预测频道成功率。
以下匹配记录和表格均为原创虚构内容，用于演示评估过程。对于 `publishedAt` 值仅包含日期的候选记录（目标视频 F1、候选视频 B、候选视频 C 和候选视频 D），精确的发布后经过时长来自本教学示例中假设的精确虚构时间戳，而不是将原生的纯日期标签转换成经过核实的小时数。根据 YouTube 官方文档，所有视频形式均在开始播放时计入观看次数的统计口径于 2026-08-24 生效；比较观看次数时，请注意这一版本分界。
主要比较表（目标视频 F1）
| 候选视频 | 题材 / 主题 | 经人工核查的形式 | 发布与观测时间 | 假定的发布后时长 | 带日期的自述频道阶段证据 | 规则判定状态 | 原因 |
|---|---|---|---|---|---|---|---|
| 目标视频 F1 | 悬疑游戏 | 长视频 | 发布：2026-10-01<br>观测：2026-10-08 | 7 天 | 2026-10-01 的帖子：“开始制作我的第 1 个悬疑系列” | 目标 | 目标比较对象 |
| 候选视频 B | 悬疑游戏 | 长视频 | 发布：2026-10-02<br>观测：2026-10-09 | 7 天 | 2026-10-02 的帖子：“我的新悬疑频道第 1 集” | 符合资格 | 符合所有已声明的规则（`claimed_stage`） |
| 候选视频 C | 悬疑游戏 | 长视频 | 发布：2024-10-08<br>观测：2026-10-08 | 730 天 | 个人简介：“自 2024 年起制作游戏视频” | 已排除 | 发布后时长不匹配（730 天与 7 天） |
| 候选视频 D | 悬疑游戏 | 短视频 | 发布：2026-10-01<br>观测：2026-10-08 | 7 天 | 2026-10-01 的帖子：“新频道上线短视频” | 已排除 | 形式不匹配（短视频与长视频） |
| 候选视频 E | 悬疑游戏 | 长视频 | 发布：2026-10-08T01:00Z<br>观测：2026-10-08T13:00Z | 12 小时 | 视频开场：“欢迎来到我的全新频道” | 已排除 | 发布后时长不匹配（12 小时与 7 天） |
| 候选视频 F | 悬疑游戏 | 长视频 | 发布：仅有日期标签<br>观测：2026-10-08 | 未知 | 未找到关于频道阶段的公开声明 | 待确定 | 缺少精确发布时间和频道阶段证据 |
次要比较记录
- 目标形式 F2（发布时长为 14 天的悬疑游戏短视频）：按该比较单元独立的规则进行评估，要求视频为悬疑游戏短视频，且处于上传后 14 天的时间边界。候选视频 D 的形式、题材和频道阶段均匹配，但不符合 F2 的发布后时长边界（实际为 7 天，要求为 14 天）。候选视频 B、C、E 和 F 不符合形式或发布后时长参数。结果：提供的候选集合中没有符合资格的参照视频；将其报告为无法比较的单元（没有依据充分的基准）。
- 计划采集记录：计划于未来的 2026-10-15T01:00Z 对候选视频 E 进行观测，以满足 F1 发布后 7 天的规则。状态：`planned_capture`（与 `observed_reference` 严格区分；无法事后还原过去发布后第 7 天的观看次数）。
来源和延伸阅读
作者 Chronometrica · 更新日期
返回顶部 ↑
