创建商品库商品诊断信息的异步下载任务

您可以使用本接口创建商品库商品诊断信息的异步下载任务。

异步下载任务创建完成后，您可以使用/diagnostic/catalog/product/task/get/ 下载生成的 CSV 文件。需注意与异步下载任务提供的诊断信息相比，/diagnostic/catalog/接口同步获取的诊断信息更为详细。异步下载任务仅返回每个检测到的问题的 Product ID（商品ID，对应 product_id ），SKU ID（自定义的商品唯一ID，对应sku_id / hotel_id / flight_id / destination_id ) ，Item title（商品标题，对应 title ），Issue title（问题标题，对应 issue_title ），Severity（问题级别，对应 issue_level ）和 Source（更新源名称）。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/diagnostic/catalog/product/task/create/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| catalog_id {必填} | string | 商品库ID。您需有访问该商品库的权限。 |
| bc_id {必填} | string | 商务中心ID。该商务中心需为所指定商品库的所属商务中心，或所指定商品库已作为资产分享给该商务中心。 |
| feed_id | string | 更新源 ID。<br>若未传入本字段，则使用商品库的默认更新源的ID。 <br>若想获取商品库所有更新源的诊断信息，需将本字段设置为 `ALL` 。 <br>若想获取某个商品库的所有更新源的ID，可使用 [/catalog/feed/get/](https://ads.tiktok.com/marketing_api/docs?id=1740665183073281)。 |
| lang | string | 想要为返回的 `issue_title` 和 `reason_and_suggestion` 字段设置的语言。<br> 默认值 `en `。 <br>支持的枚举值请查看下文的<a href="#item-link-lang枚举值">`lang`枚举值</a>小节。 |
|  issue_id | string | 问题ID，用于下载对应诊断信息。<br>您需指定一个可下载的问题的ID。可在下文的<a href="#item-link-支持下载的问题">支持下载的问题</a>小节的列表中选择问题ID。<br>若未传入本字段，则返回所有发现的问题的诊断信息。 |

`lang`枚举值

| 值 {30%}| 描述{70%} |
|---|---|
| `ar` | 阿拉伯语 |
| `cs-CZ` | 捷克语 |
| `de` | 德语 |
| `en` | 英语 |
| `es` | 西班牙语 |
| `fil` | 菲律宾语 |
| `fr` | 法语 |
| `id` | 印度尼西亚语 |
| `it` | 意大利语 |
| `ja` | 日语 |
| `ko` | 韩语 |
| `ms` | 马来语 |
| `pl-PL` | 波兰语 |
| `pt` | 葡萄牙语（巴西） |
| `ru` | 俄语 |
| `sv-SE` | 瑞典语 |
| `th` | 泰语 |
| `tr` | 土耳其语 |
| `vi` | 越南语 |
| `zh` | 中文 |

支持下载的问题

若您想下载某一问题的诊断信息，您可以将下表中的任一问题 ID 传入 issue_id。

| <code>issue_id</code>{30%} | 描述{70%} |
|---|---|
| `1101` | 必填商品属性字段缺失。 |
| `1102` | 必填字段中输入了无效值。 |
| `1103` | 商品ID（如 SKU ID）重复。 |
| `1105` | 选填字段中输入了无效值。 |
| `1106` | 缺少推荐的选填字段。 |
| `1107` | 数据源或文件中的某一行的列数与第一行的列数不一致。 |
| `1108` | 某字段值只使用大写字母。 |
| `1109` | 附加图片链接的数量超过了10的上限。 |
| `1110` | 选填的 URL 格式不正确。 |
| `1111` | 必填的 URL 格式不正确。 |
| `1112` | 使用了 非 UTF-8 编码。 |
| `1113` | 使用了表情符号或控制字符。 |
| `2001` | 由于服务器问题，无法下载图片。 |
| `2002` | 图片尺寸小于500 x 500像素。 |
| `2003` | 数据源文件或链接格式不正确。 |
| `2004` | 图片链接无效，无法下载图片信息。 |
| `3001` | 商品因包含违禁内容而被驳回。 |
| `4001` | 商品链接无效。 |
| `4002` | 无法访问商品链接。 |
| `4003` | 商品和落地页上的价格不匹配。 |
| `4005` | 未填写 Item Group ID（商品 SPU ID）字段。 |
| `4006` | 未填写附加图片链接字段。 |
| `4007` | 未填写商品类型字段。 |
| `4008` | 未填写 Google 商品类目字段。 |
| `4009` | 未填写全球贸易项目代码（GTIN）字段。 |

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/diagnostic/catalog/product/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "catalog_id":"{{catalog_id}}",
    "bc_id":"{{bc_id}}"
}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| task_id | string. | 商品库诊断信息下载任务的ID。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "task_id": "{{task_id}}"
    }
}
(/code)