René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[weixin-java-channel] WxChannelProductService 缺失赠品/买赠活动/限时抢购/库存等完整子API（共28个端点）","articleBody":"## 问题描述\n\n**WxChannelProductService**（视频号小店商品服务）缺少多个官方文档中已有的完整 API 子模块，涉及 28 个端点。\n\n### 1. 赠品管理（Gift）- 7个端点全缺\n\n官方文档：https://developers.weixin.qq.com/doc/store/shop/API/channels-shop-product/gift/api_addgiftproduct.html\n\n| 方法 | 端点 |\n|------|------|\n| addGiftProduct（添加非卖商品） | /channels/ec/product/gift/add |\n| updateGiftProduct（更新非卖商品） | /channels/ec/product/gift/update |\n| setProductAsGift（在售商品转赠品） | /channels/ec/product/gift/onsale/set |\n| getGiftProduct（获取赠品） | /channels/ec/product/gift/get |\n| listGiftProduct（获取赠品列表） | /channels/ec/product/gift/list/get |\n| updateGiftStock（更新赠品库存） | /channels/ec/product/gift/stock/update |\n\n### 2. 买赠活动（GiftActivity）- 3个端点全缺\n\n| 方法 | 端点 |\n|------|------|\n| addGiftActivity（创建赠品活动） | /channels/ec/product/activity/add |\n| deleteGiftActivity（删除赠品活动） | /channels/ec/product/activity/del |\n| stopGiftActivity（停止赠品活动） | /channels/ec/product/activity/stop |\n\n### 3. 限时抢购（LimitedDiscountTask）- 5个端点全缺\n\n| 方法 | 端点 |\n|------|------|\n| addLimitedDiscountTask（添加限时抢购任务） | /channels/ec/product/limiteddiscounttask/add |\n| updateLimitedDiscountTask（更新限时抢购任务） | /channels/ec/product/limiteddiscounttask/update |\n| deleteLimitedDiscountTask（删除限时抢购任务） | /channels/ec/product/limiteddiscounttask/delete |\n| stopLimitedDiscountTask（停止限时抢购任务） | /channels/ec/product/limiteddiscounttask/stop |\n| listLimitedDiscountTask（获取限时抢购任务列表） | /channels/ec/product/limiteddiscounttask/list/get |\n\n**注意**：SDK 中已有 `addLimitTask`、`listLimitTask`、`stopLimitTask`、`deleteLimitTask` 方法，但缺少完整的 update 接口，且命名不一致（`LimitTask` vs `LimitedDiscountTask` 语义不完全对应）。\n\n### 4. 库存管理（Stock）- 4个端点全缺\n\n| 方法 | 端点 |\n|------|------|\n| getStock（获取库存） | /channels/ec/product/stock/get |\n| getStockBatch（批量获取库存） | /channels/ec/product/stock/batchget |\n| getStockFlow（获取库存流水） | /channels/ec/product/stock/getflow |\n| updateStockFast（快速更新库存） | /channels/ec/product/stock/update |\n\n### 5. 其他缺失（9个）\n\n| 方法 | 端点 | 说明 |\n|------|------|------|\n| categoryPreCheck | /channels/ec/product/categoryprecheck | 发品前校验 |\n| getProductAuditStrategy | /channels/ec/product/auditstrategy/get | 获取商品上架策略 |\n| setProductAuditStrategy | /channels/ec/product/auditstrategy/set | 设置商品上架策略 |\n| getProductAuditQuota | /channels/ec/product/getauditquota | 获取商品提审限额 |\n| getProductBrandRecommend | /channels/ec/product/productbrandrecommend | 商品品牌推荐 |\n| externalProductMapping | /channels/ec/product/externalproductmapping | 站内外属性映射 |\n| externalProductMappingNew | /channels/ec/product/externalproductmappingnew | 站内外属性映射v2 |\n| beginTimingSale | /channels/ec/product/begintimingsale | 商品立即开售 |\n| cancelTimingSale | /channels/ec/product/canceltimingsale | 取消商品开售 |\n\n---\n\n## SDK 文件路径\n\n- Service接口：`weixin-java-channel/src/main/java/me/chanjar/weixin/channel/api/WxChannelProductService.java`\n- ServiceImpl：`weixin-java-channel/src/main/java/me/chanjar/weixin/channel/api/impl/WxChannelProductServiceImpl.java`\n- 常量类：`weixin-java-channel/src/main/java/me/chanjar/weixin/channel/constant/WxChannelApiUrlConstants.java`（Spu内部接口）\n\n## 建议\n\n1. 新增 `WxChannelGiftService` 处理赠品和买赠活动完整功能\n2. 新增 `WxChannelLimitedDiscountService` 或扩展现有 WxChannelProductService\n3. 新增 `WxChannelProductStockService` 处理库存相关接口\n4. 补充商品辅助接口（发品前校验、上架策略、属性映射等）","author":{"url":"https://github.com/binarywang","@type":"Person","name":"binarywang"},"datePublished":"2026-05-14T14:03:06.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/4002/WxJava/issues/4002"}