feat(scripts): 添加批量生成 YouTube Studio 内容管理器 URL 的脚本

This commit is contained in:
2026-08-21 18:21:03 +08:00
commit c1b39e9466
29 changed files with 4020 additions and 0 deletions

32
CONTEXT.md Normal file
View File

@@ -0,0 +1,32 @@
# YouTube Studio URL 拼接工具
根据需求清单(CSV/Excel)批量生成 YouTube Studio 内容管理器(Content Manager)高级模式 explore 报告 URL 的小工具。领域词汇统一如下。
## Language
**所有者(Content Owner)**:
拥有内容管理器的账号实体,URL 中通过 `o` 参数与路径 `/owner/<owner_id>/` 标识。
_Avoid_: 账号、客户、商户
**实体(Entity)**:
报告统计的对象,由 `entity_type` + `entity_id` 标识,包括所有者(CONTENT_OWNER)、群组(GROUP)、频道(CHANNEL)、节目(VIDEO)。
_Avoid_: 对象、目标
**群组(Group)**:
内容所有者名下用于组织一批频道/资产的实体,`entity_id` 为其 groupId(如 `NCy9C2QPQ1E`)。
**需求(Requirement)**:
输入清单中的一行,描述一条待生成 URL 的完整条件:所有者名称、所有者ID、实体类型、实体名称、实体ID、数据周期、国家筛选。
**实体ID(entity_id)**:
URL 中 `entity_id` 参数的值;按实体类型不同取群组ID / 频道ID / 节目ID;所有者场景下即所有者ID。
**数据周期(Period)**:
需求中形如 `yyyy.mm.dd-yyyy.mm.dd` 或 `yyyy.m.d-yyyy.m.d` 的日期区间,起始日与结束日均包含在数据范围内。
**日界线(Day Boundary)**:
周期中某日期对应的 Unix 毫秒时刻,采用「锚点 2026-06-15 = 1781506800000 + 整日偏移」计算,不做时区数学。
_Avoid_: 时间戳换算、时区转换
**国家筛选(Country Filter)**:
`ur_dimensions=COUNTRY` + `ur_values` 的筛选参数;多国以 `'`(`%27`)包裹、`|`(`%7C`)连接,如 `%27US%27%7C%27JP%27`。国家以 ISO 3166-1 alpha-2 代码表示。