淘宝视频ID采集用户说明
说明如何从淘宝视频空间采集视频名称、视频ID和发布状态，整理视频名称与商品对应关系，并生成淘宝主图视频批量导入所需的CSV文件。
淘宝视频 ID 采集用户说明
这个功能是做什么的
淘宝视频 ID 采集用于从淘宝视频空间里采集视频名称、视频 ID 和发布状态，并继续生成平台要求的主图视频 CSV 导入文件。
它解决的是淘宝视频上传后的后半段问题：
本地视频上传到淘宝视频空间
-> 采集视频名称、视频 ID 和发布状态
-> 检查视频名称是否能对应商品 ID
-> 生成主图视频平台导入文件
-> 后续用于批量关联商品主图视频简单说，上传视频只是把视频放到淘宝视频空间。要批量把视频关联到商品，还需要知道每个视频在平台里的视频 ID。
本页生成的 CSV 只用于淘宝商品的第 1 个主图视频，当前功能不会替你把 CSV 导入平台，也不会直接关联商品。生成后还要按平台入口完成导入，并核对实际结果。
适合什么场景
这个功能适合以下情况：
- 你已经把一批商品视频上传到淘宝视频空间。
- 视频名称已经按商品 ID 命名，想批量生成主图视频平台导入文件。
- 你需要检查哪些视频名称有冲突，哪些视频状态不能关联。
- 你想把视频 ID 和商品 ID 对起来，减少人工复制粘贴。
- 你需要导出一张清楚的采集结果表，方便后续处理。
如果视频还没有上传到淘宝视频空间，请先使用 18_商品视频批量上传_用户说明。
使用前要准备什么
1. 淘宝店铺环境
店铺来自账号中心已经绑定并验证的店铺列表，登录环境由系统自动分配。先确认选择的是正确淘宝店铺。
淘宝视频空间属于具体店铺。不要把 A 店的视频采集结果拿去给 B 店商品使用。
验证码和滑块会先由本机自动处理，未解除时再调用系统中已启用的打码服务；仍未解除时会保留页面并进入安全等待。扫码、短信、账号二次身份确认和登录失效仍需要你本人处理。
2. 视频空间分类
建议视频上传时就按批次放进清楚的分类。
例如：
女装外套_A店_本批视频采集时选择这个分类，就能减少无关视频干扰，也更容易检查本批视频是否完整。
3. 视频名称规则
建议视频名称尽量等于商品 ID。
后面生成主图视频平台导入文件时，最常见的对应方式就是：
视频名称 = 商品 ID如果视频名称不是商品 ID，而是“新视频1”“款式视频A”这种名称，就很难准确生成关联模板。
系统不会验证“视频名称”是否真的是淘宝商品 ID，只会去掉可能存在的文件扩展名，再把剩余完整文字当作商品 ID。使用“新视频1”这类名称时，冲突检查不一定自动报错；最稳妥的做法是填写正确的商品 ID 来源表来限制范围，并人工抽查。
4. 采集结果输出表
采集结果输出表用于保存本次从淘宝视频空间读取到的数据。
当前采集表固定包含：
- 商品 ID（按视频名称整理）。
- 视频名称。
- 视频编码（平台视频 ID）。
- 公域状态。
- 采集时间。
- 分类名称。
后面生成主图视频平台导入文件时，会继续读取这张表。
采集过程按“视频编码”去重；同一视频编码再次出现时，后读取的记录会覆盖前一条，并在执行报告中累计重复数量。因此采集结束后还要检查重复视频编码和重复视频名称，不能只看最终行数。
5. 商品 ID 来源表
商品 ID 来源表是可选的。
这份下载文件带有标题和说明行，只用于查看字段结构，不能直接选进正式任务。正式商品来源表的第 1 行必须直接写字段名；默认字段名是 商品ID，中间没有空格。如果你的真实表头不同，要在页面“商品ID列”中填写完全一致的表头文字。
当前读取支持 .xlsx、.xlsm 和 .csv，不支持旧版 .xls。如果选择了商品来源表，但实际没有读到任何商品 ID，当前处理会退回“不限制商品范围”；因此冲突检查结果中的商品数量为 0 时必须停止，不要继续生成或导入。
如果你只想为某张商品表里的商品生成主图视频平台导入文件，可以填写它。这样可以避免把视频空间里无关商品的视频也放进导入文件。
如果不填，就主要依据采集结果表和视频名称进行处理。
推荐操作流程
第一步：先确认视频已经上传完成
进入淘宝视频空间，确认本批视频已经能看到。
重点检查：
- 视频数量是否和本批上传数量一致。
- 视频名称是否清楚。
- 视频是否放在正确分类里。
- 视频状态是否可用。
- 是否有重复名称或异常状态。
如果视频还没上传完成，不要急着采集。
第二步：填写视频 ID 采集设置
在“淘宝视频 ID 采集任务”区域填写：
- 淘宝店铺环境。
- 当前分类备注。
- 文件名前缀。
- 采集结果保存目录或完整文件路径。
- 可发布状态文案。
- 指纹重复状态文案。
- 选择分类等待秒数。
- 本次最多采集页数和视频数。
- 每采集多少条停顿。
- 页内停顿最小值和最大值。
- 翻页加载等待最小值和最大值。
- 翻页前等待最小值和最大值。
- 失败时是否保留浏览器现场。
这些等待时间用于让页面有足够时间加载视频列表。视频数量多、网络慢、页面卡时，可以适当调大。
页面顶部的设置模板会保存本页面当前填写的采集范围、等待时间、输出路径、列名、商品来源表、状态筛选和所选店铺。应用模板后要重新核对店铺、分类等待、输入表和输出目录；浏览器环境目录不会保存进模板。
第三步：启动采集任务
启动“淘宝视频 ID 采集任务”。
任务会打开淘宝视频空间。页面打开后，请在“选择分类等待秒数”结束前，从左侧手动选择本批视频所在分类；系统不会替你猜分类。等待结束后，系统读取当前选中的分类，并把视频信息输出到采集结果表。
正式开始采集后，不要再手动切换分类、刷新页面或关闭浏览器，否则可能影响采集结果。
第四步：检查采集结果
采集完成后，先打开采集结果输出表。
重点看：
- 视频名称是否完整。
- 视频 ID 是否都有值。
- 发布状态是否可关联。
- 是否有重复视频名称。
- 是否有指纹重复或不可关联状态。
如果视频名称不等于商品 ID，要先处理命名问题，再生成主图视频平台导入文件。
如果任务中途失败，已完成页面的采集结果可能已经写入输出表，但该表只是部分结果。要结合执行报告中的采集页数、行数和失败状态判断，不能把文件存在当成采集完整。
第五步：检查关联冲突
在“生成主图视频平台导入文件”区域，可以先点击“检查关联冲突”。
它的目的不是直接生成最终模板，而是先发现这些问题：
- 一个商品 ID 对应多个视频。
- 视频名称或视频编码为空。
- 商品来源表里的商品没有匹配视频，或视频名称不在限定商品范围内。
- 视频状态被当前筛选排除。
- 视频名称有重复或冲突。
同一商品 ID 对应多个不同视频 ID、缺少视频名称或视频编码属于阻断问题，系统不会生成平台导入文件，只会保留诊断报告。同一视频 ID 被多个商品复用、商品来源表中有商品未找到视频等情况只会给出警告，不会自动阻止生成，必须由你确认是否符合业务规则。
第六步：生成主图视频平台导入文件
冲突检查通过后，再生成平台要求的 CSV 导入文件。
生成前需要确认：
- 采集结果输入表正确。
- 商品 ID 来源表是否需要限制范围。
- 平台导入文件保存目录正确。
- 视频名称列、视频 ID 列、公域状态列、商品 ID 列填写正确。
- 可关联状态文案符合你当前采集结果。
- 是否排除已识别为不可发公域的视频。
导入文件生成后，建议打开检查几行，确认商品 ID 和视频 ID 对应关系没有错。CSV 是淘宝平台实际导入格式，不是让用户手工填写的参考模板；字段核对资料只提供 XLSX 或 TXT。
页面字段怎么理解
当前分类备注
这是页面无法识别当前分类时使用的备注，不会自动替你点击分类。
建议上传视频时就把本批视频放到单独分类。启动任务后，在等待时间内从淘宝视频空间左侧手动选中该分类，采集时就不会混入其它批次。
文件名前缀
用于输出文件命名，方便你区分不同批次。
它不是视频筛选条件。不要误以为填了前缀后，只会采集这个前缀的视频。
采集结果保存目录
保存商品 ID、视频名称、视频编码、公域状态、采集时间和分类名称等结果。
选择目录时，系统会按“文件名前缀-当前分类.xlsx”生成文件名；手动填写完整的 .xlsx 或 .csv 路径时，按该文件名保存。
后面生成主图视频平台导入文件会读取它。
指纹重复状态文案
用于识别平台提示里的重复状态。
如果平台提示某些视频内容重复，采集结果里需要能把这种状态标出来，方便后面判断是否可关联。
可发布状态文案
用于识别哪些视频可以进入后续主图视频关联模板。建议保持默认值，只有平台页面状态文字发生变化时再调整。
选择分类等待秒数
浏览器打开视频空间后，系统会先等待这段时间。你要在等待结束前从左侧选中本批分类；网络较慢或分类较多时，可以适当调大。
本次最多采集页数 / 本次最多采集视频数
填 0 表示不限制。需要先做小批量检查时，可以填写较小的页数或视频数；确认结果正确后再改回 0 采集全部。
每采集多少条停顿
用于控制采集节奏。
视频数量多时，适当停顿可以减少页面来不及加载导致的漏采。
页内停顿最小值 / 页内停顿最大值
用于控制读取同一页视频时的等待时间。
页面加载慢时，可以适当调大。
翻页加载等待最小值 / 翻页加载等待最大值
用于控制翻页后等待列表加载的时间。
如果翻页后视频信息经常不完整，可以适当调大。
翻页前等待最小值 / 翻页前等待最大值
用于控制点击下一页前的等待时间。
有些页面在翻页前还会保存或刷新当前状态，等待太短可能会影响结果。
采集结果里的公域状态
这是采集结果表中的输出信息，不是一个单独开关。它用于记录视频是否可发公域或是否出现指纹重复等状态。
不要只看视频 ID，还要看发布状态。
生成冲突清单
这是下方“检查关联冲突”动作生成的诊断结果，不是视频采集任务里的开关。它会把名称冲突、状态异常、无法关联等情况列出来。
生成平台导入文件前建议先看冲突清单。
采集结果输入表
生成主图视频平台导入文件时读取的采集结果表。
通常就是前一步采集出来的结果文件。
商品 ID 来源表
可选。
填写后，只为这张表里的商品 ID 生成主图视频平台导入文件。适合你只想处理本批商品，不想混入视频空间里其它视频的情况。
平台导入文件保存目录
平台 CSV 导入文件保存的位置。选择目录即可，系统会生成正确的 .csv 文件；不要把扩展名手工改成 .xlsx，否则文件名和实际内容会不一致。
建议按店铺、日期和批次命名，方便后续导入和回查。
视频名称列 / 视频 ID 列 / 公域状态列 / 商品 ID 列
这些字段用于告诉页面：表格里哪一列对应哪个信息。
这里填写的是第 1 行的表头文字，不是 A/B/C 列号或数字列号。视频名称列、视频 ID 列和公域状态列对应采集结果表；商品 ID 列对应可选的商品来源表。如果列名填错，可能读不到限制范围或生成错误对应。
可关联状态文案
用于判断哪些已识别状态可以进入主图视频平台导入文件。
不同批次或页面显示可能有不同文字，填写时要和采集结果里的状态保持一致。
排除已识别为不可发公域的视频
开启后，会排除“已经识别到公域状态、且状态不等于可关联状态文案”的记录。
此选项当前默认开启。公域状态为空的记录不会被自动排除，因此不能把它理解为“已经确认全部视频都可发”。生成前仍要检查采集结果和冲突报告。
常见问题
为什么视频已经上传了，还要采集视频 ID
上传完成只是视频进入了淘宝视频空间。
要批量关联商品主图视频，还需要知道平台里的视频 ID。采集视频 ID 后，才能继续生成主图视频平台导入文件。
为什么生成平台导入文件前要检查冲突
因为视频名称和商品 ID 不一定一一对应。
常见冲突包括：
- 一个商品 ID 对应多个视频。
- 多个视频名称相同。
- 视频名称不是商品 ID。
- 视频状态不可关联。
- 商品表里有商品 ID，但视频空间里找不到对应视频。
先检查冲突，可以减少导入后关联错误。
为什么视频名称最好等于商品 ID
这样最容易自动对应。
如果视频名称是商品 ID，生成平台导入文件时就可以直接根据名称找到商品。否则就需要额外表格或人工整理对应关系。
为什么有些视频没有进入模板
可能原因包括：
- 视频状态不符合可关联条件。
- 开启了“排除已识别为不可发公域的视频”。
- 视频名称和商品 ID 对不上。
- 商品 ID 来源表限制了处理范围。
- 采集结果表列名或列号填写不正确。
为什么采集很慢
视频空间页面需要加载列表、状态和分页信息。
如果视频很多，采集慢是正常的。不要把等待时间调得太低，否则可能出现漏采或状态读取不完整。
“失败时保留浏览器现场”会保留什么
任务失败后，系统会使用同一店铺登录环境重新打开淘宝视频空间，方便你检查登录、分类和页面状态。页面中尚未提交的临时内容不一定能够原样保留，具体失败原因仍应以任务中心和采集报告为准。
商品 ID 来源表一定要填吗
不一定。
如果你只想处理某一批商品，建议填写。 如果你想根据采集结果直接生成平台导入文件，可以不填，但要更注意视频名称和商品 ID 是否一致。
使用建议
- 上传视频时就按批次建立视频空间分类。
- 视频名称尽量等于商品 ID。
- 先采集，再检查冲突，再生成平台导入文件。
- 不要跳过发布状态检查。
- 第一次先处理少量视频，确认平台导入文件格式和对应关系。
- 采集过程中不要手动切换分类或翻页。
- 如果视频很多，等待时间不要设得太短。
- 生成平台导入文件后先打开检查几行，再继续后续导入。
- 失败时先看任务中心和采集结果表。
云店Agent能帮你什么
云店Agent可以帮你理解采集结果和任务记录，也可以帮你排查为什么某些视频没有进入模板。
你可以这样问：
- “淘宝视频上传后为什么还要采集视频 ID？”
- “为什么这个视频没有生成到主图视频平台导入文件？”
- “视频名称和商品 ID 怎么对应？”
- “这个冲突清单是什么意思？”
- “排除已识别为不可发公域的视频是什么意思？”
- “我应该先检查冲突，还是直接生成平台导入文件？”
涉及确认店铺、确认视频状态、确认平台导入文件内容等关键动作时，建议你自己看清楚后再继续。