# 带货视频发布流程

TikTok Shop 带货视频发布流程与标准接口：选择达人、选品与排期、视频上传、商品标题/音乐/封面设置、可选预审、创建发布任务与发布记录。

- 网页文档: [带货视频发布流程](/openapi/workflows/commerce-video)
- Markdown: [Markdown](/openapi/workflows/commerce-video.md)
- 接口索引: [接口索引](/openapi/operations/index.json)

## 发布流程图

```mermaid
flowchart TD
  A["已完成授权的达人"] --> B["选择达人"]
  B --> C["选品与排期"]
  C --> D["上传 1 条视频"]
  D --> E{"预签名 isNew?"}
  E -- "是" --> F["PUT + confirm"]
  E -- "否" --> G["复用 fileId"]
  F --> H["带货设置：标题、音乐、封面、AI 标识"]
  G --> H
  H --> I["校验；预审选填（仅视频）"]
  I --> J{"定时发布?"}
  J -- "立即" --> K["createPost scheduledAt=当前时间"]
  J -- "定时" --> L["createPost 排期时间 + scheduledTz"]
  K --> M["发布记录"]
  L --> M
```

## 每一步做什么

1. 第 1 步 · 选择达人：查询账号传 authSource=TIKTOK_SHOP_CREATOR；permissions 同时包含 LIVE_STREAM_PERMISSION 和 SELF_SALE_PERMISSION 时，一定具备带货视频权限；创建任务用 creatorId，查商品用账号 id。
2. 第 2 步 · 选品与排期：选择店铺或橱窗商品，设置发布日期或立即发布。
3. 第 3 步 · 上传视频：presign → isNew=true 时 PUT → confirm；businessId 传字符串 fileId，businessType=FILE。
4. 第 4 步 · 带货设置：商品标题、音乐、封面（截帧或上传）和 AI 标识；自定义封面上传需 returnCoverFileId=true。
5. 第 5 步 · 校验与创建：预审选填且仅视频；定时至少提前 5 分钟；调用 createPost 传 scheduledAt 与 scheduledTz。
6. 发布后：查询记录获取预审结果、平台作品 ID 和失败原因；按需立即发布、修改或取消。

## 关键分支

- **定时 / 立即发布**：定时至少提前 5 分钟；立即用当前时间。
- **新视频 / 秒传**：只有 isNew=true 需要 PUT 和 confirm。
- **预审是选填**：仅视频支持；超时后继续发布。
- **封面：截帧或上传**：coverTimestampMs 与 coverUri/coverFileId 互斥。
- **创建成功 ≠ 发布成功**：最终状态以发布记录为准。

## 接口顺序

| 步骤 | 接口 |
|---|---|
| 1 | [GET /v1/creatorAccount/pageList](/openapi/creators) |
| 2 | [GET /v1/creator/tiktokshop/product/listByShop](/openapi/shop-products) · [GET /v1/creator/tiktokshop/product/listByShowcase](/openapi/showcase-products) |
| 3 | [POST /v1/file/presign](/openapi/presign) · `PUT presigned URL` · [POST /v1/file/confirm](/openapi/confirm) |
| 4 | [GET /v1/creator/tiktokshop/searchMusic](/openapi/search-music) · [POST /v1/creator/tiktokshop/uploadPhoto](/openapi/upload-tiktok-cover) |
| 5 | [POST /v1/creator/post/create](/openapi/create-post) |
| 6 | [GET /v1/creator/post/pageList](/openapi/post-records) · [POST /v1/creator/post/submit](/openapi/submit-post) · [POST /v1/creator/post/update](/openapi/update-post) · [POST /v1/creator/post/cancel](/openapi/cancel-post) |

## 接入提示

- 发布前达人必须完成 TikTok Shop 授权。
- 商品标题会校验长度和禁用字符。
- 自定义封面需要 returnCoverFileId=true，发布时传 photoFile.photoUri 与 coverFileId。
- scheduledAt 是绝对时间戳，scheduledTz 是 IANA 时区。
