DevTipRule一般用于给开发者提示,不需要展示给用户,开发者可以通过此Rule获取特定的信息,如例子中的如何获取售后模板信息。以售后模板为例:
例如:maxValueRule中value=2且exProperty=include时,表示返回值必须小于等于2;maxValueRule中value=2且exProperty=notinclude时,表示返回值必须小于2
maxTargetSizeRule和minTargetSizeRule有个unit属性,表示规则的单位。这两个rule的单位主要有kb、mk、gb等,表示文件大小的单位。maxLengthRule和minLengthRule也有unit属性,表示长度计量单位,有byte和character两种单位.
例如:“a汉字”这个字符串,当单位为byte时,长度是5,当单位是character时,长度是3
由于业务的变化速度非常快,开发者实现一个变更检测的功能,对于天猫商家来说,每天定期拉取商家对应类目下规则,比较xml差异,根据差异进行业务处理的调整;
开发者需要针对每一个商家实现一个动态映射的能力,将本地数据与线上返回的xml结构的元素进行一一映射,改变以前的写死参数的方式,这是接入schema体系最重要的事情
增量更新的字段有限,按需提交filed的value(s)即可,新版中不需要update_fields字段。
涉及接口:
说明:天猫商品需要挂靠产品,所以产品发布仅支持天猫店铺;淘宝和特价版商品无需挂靠产品,不需要产品发布,直接按照“步骤三”发布商品即可。
类目:女装/女士精品>>POLO衫(类目id:201241307)为例说明产品发布步骤;
涉及API:tmall.product.match.schema.get
入参:category_id=201241307;
出参:规则xml
如果没有返回产品匹配规则,说明该类目不需要发布产品,直接到"步骤三:发布商品"。
涉及API:tmall.product.schema.match
入参:category_id=201241307;propvalues=xml_data(示例XML如下)
调用tmall.product.schema.get查询产品状态【
产品状态(true)如果返回true则可以直接发布商品(直接到"步骤三:发布商品"。)
产品状态(false)如果返回false则需要等待。
涉及API:tmall.product.add.schema.get
入参:category_id=201241307;brand_id=10000497
涉及API:tmall.product.schema.add
入参:category_id=201241307;brand_id=10000497;xml_data;
出参:产品idproduct_id;
注意:部分产品发布后需要审核通过后才可使用,所以需要等待产品状态可用后再发布商品。
备注:1、如果获取产品规则tmall.product.add.schema.get获取为空时,说明该类目为无关键属性类目,直接去发布商品即可。
2、产品schema接口继续使用老的schemaSDK协议;
新老schema协议差异
1)
字段
老协议
新协议
是否变动
ComplexField
complex-values
complex-value
是
MultiComplexField
否
2)所有field的default-complex-values/default-values/default-complex-value/default-value都已取消,统一用field的值取代。
当第二步的产品可用后,即可发布商品
alibaba.item.publish.schema.get
alibaba.item.publish.props.get
alibaba.item.publish.submit
TIPS:开发者如果涉及需要获取某一类目下的商品上新的所有规则,可以同时调用tmall.product.add.schema.get接口获取产品发布涉及的规则,然后入参需要注意spu_id传入0调用alibaba.item.publish.schema.get获取商品发布的通用规则(非全部规则)
涉及API:alibaba.item.edit.schema.get
说明:全量和增量编辑的规则都使用接口alibaba.item.edit.schema.get获取。
增量编辑规则获取还需入参fields,比如传入fields=title,接口alibaba.item.edit.schema.get只获取title的编辑规则。
涉及API:alibaba.item.edit.submit
涉及API:alibaba.item.edit.fastupdate
说明:
A)目前淘宝支持的增量更新字段有:catId,bizIdentity,id,price,quantity,title,wirelessDesc,desc,barcode,outerId,video,images,recommendReason,imageVideo,sellPromise
B)天猫市场支持增量更新的字段如下:
title(标题)
subtitle(子标题,即卖点)
show_title(展示标题)
short_title(无线短标题)
description(商品描述)
wireless_desc(旺铺无线详情描述)
vertical_image(竖图)
white_bg_image(白底图)
large_screen_image(电子大屏图)
shop_category(店铺类目)
item_image(主图)
item_wireless_images(无线主图)
postage_id_increment(运费模板id)
image_video_type(主图视频比例类型)
main_video(主图视频)
three_to_four_images(3:4商品图片)
说明:关于主图视频,目前商品已经支持3:4主图视频,并且支持3:4商品主图图片更新,建议三个字段为一个组件来使用;
C)特价版支持增量更新的字段如下:
title(宝贝标题)
catProp(类目属性)支持修改枚举类型字段,不支持修改input类型的字段;
sku(宝贝销售规格)支持修改已有sku的价格、库存、商家编码等信息,但不能新增sku;新增sku要用全量接口alibaba.item.edit.submit,并且先设置销售属性;
price(特价)需与marketPrice同时修改;
marketPrice(划线价)需与price同时修改;
quantity(总数量)
outerId(商家编码)
images(宝贝图片)
clearImage(非牛皮癣图)
imageVideo(主图视频)
verticalImage(宝贝长图)
desc(商品描述)
subStock(库存计数)
tbDeliveryTime(发货时效)
tbExtractWay(运费)
invoice(提供发票)
warranty(保修服务)
sellPromise(退换货承诺)
sevenDaySupport、sevenDayOptional(七天退货)
TIPS1:建议开发者将增量接口支持的每个元素独立封装,这样性能上更优越,报错也会更少。