Files
StudioLift/CONTEXT.md

33 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 代码表示。