诺云开放平台

Appearance

删除直播间商品 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/RoomManager/Shop/deleteGoods/2.0.0
  • 频率限制：10秒100次

请求参数 ​

参数必选类型描述
room_id是integer直播间ID
goods_ids_str是string商品ID，多个用逗号分隔
custom_menu_id是integer菜单ID

请求示例 ​

json
{
    "room_id": 628564011,
    "goods_ids_str": "1022786",
    "custom_menu_id": 1243597
}

批量删除商品示例 ​

json
{
    "room_id": 628564011,
    "goods_ids_str": "1022786,1022787,1022788",
    "custom_menu_id": 1243597
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
data是object响应数据

响应示例 ​

成功响应 ​

json
{
  "msg": "Success",
  "code": 200,
  "data": {}
}

失败响应 ​

json
{
  "code": 400,
  "msg": "商品不存在或已被删除",
  "data": {}
}

返回值状态码说明 ​

状态码描述
200成功
400失败

使用说明 ​

1. 删除方式 ​

  • 单个删除：goods_ids_str 传单个商品ID，如 "1022786"
  • 批量删除：goods_ids_str 传多个商品ID，用英文逗号分隔，如 "1022786,1022787,1022788"

2. 参数要求 ​

  • 商品ID格式：多个商品ID之间必须用英文逗号（,）分隔，不能有空格
  • 菜单ID必填：需要指定从哪个菜单中删除商品
  • 权限验证：需要确保有操作该直播间的权限

3. 删除效果 ​

  • 商品将从指定直播间菜单中移除
  • 不会删除商品本身，只是取消关联关系
  • 如果商品正在讲解中，删除后讲解状态会自动取消

注意事项 ​

  1. 权限验证：需要确保有操作该直播间的权限
  2. 商品状态：删除前建议检查商品是否正在讲解或推荐中
  3. 菜单关联：删除操作只影响指定菜单，不影响其他菜单
  4. 批量操作：支持批量删除，但建议单次不超过100个商品
  5. 不可恢复：删除操作不可恢复，需要重新添加商品到直播间

错误情况 ​

错误信息可能原因解决方案
直播间不存在直播间ID无效检查直播间ID是否正确
商品不存在或已被删除商品ID无效或已删除确认商品ID是否在该菜单中
权限不足无操作权限确认账号有直播间管理权限
菜单不存在菜单ID无效检查菜单ID是否正确

相关接口 ​

业务场景 ​

  1. 商品下架：临时或永久下架某些商品
  2. 库存管理：移除库存不足的商品
  3. 活动结束：删除活动期间的特价商品
  4. 商品更新：删除旧商品，准备添加新商品
  5. 直播调整：根据直播内容调整商品列表

操作流程 ​

1. 获取直播间菜单商品列表
   ↓
2. 确认要删除的商品ID
   ↓
3. 调用删除接口移除商品
   ↓
4. 商品从直播间菜单中移除

最佳实践 ​

  1. 删除前确认：在删除前向用户确认操作
  2. 批量处理：对于大量商品，使用批量删除提高效率
  3. 状态检查：删除前检查商品是否在讲解或推荐中
  4. 日志记录：记录删除操作日志，便于问题排查
  5. 权限控制：确保只有授权用户可以执行删除操作