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、数据周期、国家筛选。
**实体IDentity_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 代码表示。