创建/更新商品接口
用于创建和修改商品。
接口说明
- 创建或更新商品。
- 对于同一服务商,相同的out_id会被认为是同一商品,重复创建会被覆盖(相当于修改)。
- 商品和SKU属性字段(attr_key_value_map ),需要通过【查询商品模板接口】(https://developer.open-douyin.com/docs/resource/zh-CN/local-life/develop/OpenAPI/general-capabilities/product-query/template.get)获取
- 新增商品二级类型参数 product_sub_type (仅小程序酒旅预售应用)
- 创建商品时设置金额与前端用户侧展示关系,见下图。
- 顺序:先上预订商品,再上预售商品,上预售商品时通 过 bind_skus 字段关联。
- 注意:如果预售券为多预订商品多门店的通兑券,则需要在 bind_skus 中绑定多门店的预订商品,且在 pois(适用门店)字段中传入对应预订商品所属的 POI_IDs。
attr_key_value_map的格式
根据「查询商品模板」查出的模板,可以看到该行业该类型下的商品对应的可传的相关属性,技术需要关心的字段主要是以下几个:
- key - 属性主键,attr_key_value_map的key是什么
- is_required - 是否必传
- is_multi - 是否列表,需要和value_type组合起来看。例如:
- value_type=STRING(表示字符串,具体参见下文),is_multi=true,则表示value是一个字符串列表(也就是list<string>)类型;
- value_type=IMAGE(表示图片控件,具体参见下文),is_multi=true,则表示value是一个图片控件结构体列表(也就是list<ImageStruct>)类型;
- value_type - attr_key_value_map的value类型,枚举可参见后文的表格。
attr_key_value_map的类型是map<string,string>,如果value_type为其他值类型需转换为string
- value_type为整数/浮点数:转为十进制格式的string
- value_type为布尔值:转为"true"或"false"
- value_type为结构体或结构体列表:需要使用json序列化
商品属性详细介绍参考文档:商品发布和查询能力
- ignore_inapplicable_poi: