删除商品

您可以使用本接口批量删除商品。

您将会从返回中得到一个任务处理 ID（feed_log_id）。通过该ID您可以调用/catalog/product/log/查看任务的处理状态和最终结果。

注意

同一商品库下SKU唯一，且仅归属于某一更新源。针对某SKU的所有操作需要在其归属的更新源下进行。
对于每个商品库，您每小时最多可以发送 1,000 次请求。若您需要增加频次上限，请联系您的TikTok销售代表。
对于每个商品库，您一次只能发送一个操作请求，该请求包括上传和删除。如果您同时发送两个请求，则后一个将失败。我们建议您在前一个请求完成后再发送下一个请求。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/catalog/product/delete/| /v1.3/catalog/product/delete/| |请求参数类型|bc_id: number catalog_id: number sku_ids: number[]|bc_id: string catalog_id: string sku_ids: string[]| |请求参数名称和类型|feeds_id: number|feed_id: string| |新增请求参数|/|hotel_ids flight_ids destination_ids vehicle_ids series_ids| |返回参数类型|feed_log_id: number|feed_log_id`: string|


## 请求

**地址**  https://business-api.tiktok.com/open_api/v1.3/catalog/product/delete/

**方法**  POST

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

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string|商务中心 ID。<br><br>若想获取您有权访问的商务中心列表，可使用[/bc/get/](1737115687501826.html)。|
|catalog_id {必填}|string|商品库 ID。<br><br> 若想获取您有权访问的商品库列表，可使用[/bc/asset/get/](1739432717798401.html)并将 `asset_type` 设置为 `CATALOG`。|
|sku_ids {+条件必填}|string[]| 对于电商商品库的商品必填。 <br> <br>想要删除的电商商品的 SKU ID 列表。<br><br>最大数量：1,000。<br>长度限制：每个 SKU ID 最大 100 个字符，不能包含表情符号。<br><br>若想获取电商商品库中商品的 SKU ID，可使用[/catalog/product/get/](1740564136678402.html)。商品的 SKU ID 将通过返回参数 `sku_id` 返回。<br><br><p><span style="color:darkred"><b>注意</b></span>：不支持重复的 SKU ID。|
| hotel_ids {+条件必填} | string[] | 对于酒店商品库的商品必填。 <br> <br>想要删除的酒店的 ID 列表。<br> <br>最大数量：1,000。<br>长度限制：每个酒店 ID 最大 100 个字符。<br><br>若想获取酒店商品库中酒店的 ID，可使用[/catalog/product/get/](1740564136678402.html)。酒店的 ID 将通过返回参数 `hotel_id` 返回。 <br> <br><p><span style="color:darkred"><b>注意</b></span>：不支持重复的酒店 ID。 |
| flight_ids  {+条件必填} | string[] | 对于航班商品库的商品必填。<br> <br>想要删除的航班的 ID 列表。<br> <br>最大数量：1,000。 <br> 长度限制：每个航班 ID 最大 150 个字符。 <br><br>若想获取航班商品库中航班的 ID，可使用[/catalog/product/get/](1740564136678402.html)。航班的 ID 将通过返回参数 `flight_id` 返回。<br><br><p><span style="color:darkred"><b>注意</b></span>：不支持重复的航班 ID。 |
| destination_ids  {+条件必填} | string[] | 对于目的地商品库的商品必填。 <br> <br>想要删除的目的地的 ID 列表。<br> <br>最大数量：1,000。 <br>  长度限制：每个目的地 ID 最大 100 个字符。<br><br>若想获取目的地商品库中目的地的 ID，可使用[/catalog/product/get/](1740564136678402.html)。目的地的 ID 将通过返回参数 `destination_id` 返回。<br><br><p><span style="color:darkred"><b>注意</b></span>：不支持重复的目的地 ID。 |
| vehicle_ids {+条件必填} | string[] | 对于汽车库存商品库或汽车型号商品库中的车辆必填。<br><br>想要删除的车辆的 ID 列表。<br><br>最大数量：1,000。<br><br>长度限制：每个车辆 ID 最大 100 个字符，不能包含表情符号。<br><br>如需获取汽车库存商品库或汽车型号商品库中车辆的车辆 ID，可使用 [/catalog/product/get/](1740564136678402.html)。可从返回参数 `vehicle_id` 中获取车辆 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>:不支持重复的车辆 ID。</p> |
|series_ids  {+条件必填}| string[] | 对于短剧商品库的商品必填。<br> <br>想要删除的短剧的 ID 列表。<br> <br>最大数量：1,000。<br>长度限制：每个短剧 ID 最大 100 个字符。<br><br>若想获取短剧商品库中短剧的 ID，可使用 [/catalog/product/get/](1740564136678402.html)。短剧的 ID 将通过返回参数 `series_id` 返回。<br> <br><p><span style="color:darkred"><b>注意</b></span>: 不支持重复的短剧 ID。|
|feed_id|string|更新源 ID。<br><br>如果该值为空，则操作该商品库的默认更新源。|

示例

(code curl http)

    curl -X POST -H "Access-Token:YOUR_ACCESS_TOKEN" \
    -H "Content-Type:application/json" \
    -d '{\"bc_id\": BC_ID,\"catalog_id\": CATALOG_ID,\"feed_id\": FEEDS_ID,\"sku_ids\": [\"SKU_IDS\"]}' \
    https://ads.tiktok.com/open_api/v1.3/catalog/product/delete/

(/code)

|字段|类型|描述|
|--- |--- |--- |
|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|返回数据。|
#|feed_log_id| string|商品处理日志ID。|

示例

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