百度智能小程序 服务资源提交

2020-09-05 14:47 更新

服务资源提交介绍

1. 服务资源说明

服务资源提交后可统一存储至服务资源库,服务资源库是指小程序服务数据的统一管理库,开发者只需提交小程序服务资源,即可执行资源的统一存储与分发,一次提交的服务资源可在搜索信息流双引擎分发,有效提升分发效率,节省服务资源的提交与管理成本。备注:1、服务资源库只接收服务数据。2、当前服务资源库仅为邀请制(结合小程序服务闭环体验整体评估),暂未开放申请,感谢关注,敬请期待。

2. 服务资源提交接口

解释:提交/修改素材接口,API 实时接口提交方式。

若有资源在小程序内需要提交或资源推送错误需要修改(或更新)的情况,请调用该接口进行资源的提交,每次最多提交 50 个服务。
 POST https://openapi.baidu.com/rest/2.0/smartapp/server/submit/sku

公共请求参数

参数类型是否必填描述示例值
access_tokenstring小程序权限校验 Token--

请求方式说明:请 POST 方式提交,且设置 header['content-type'] 为 application/json

body 请求参数

[
    {
        "path": "/pages/detail/detail?id=100001",
        "trade_type": 5001,
        "title": "北京市北京大酒店",
        "desc": "北京大酒店欢迎您的光临",
        "images": [
            "https://mbs1.bdstatic.com/searchbox/mappconsole/image/20200623/90466909-d187-4a3e-a9ee-14ec842eae00.jpg"
        ],
        "region": "北京市",
        "price_info": {
            "org_unit": "天",
            "org_price": "300",
            "real_price": "200",
            "range_min_price": null,
            "range_max_price": null
        },
        "tag": "饮食健康;中餐",
        "button_name": "预订/立即预订",
        "activity_info": [
            {
                "activity_type": "领券",
                "activity_desc": "满10减2",
                "activity_path": "/activity/coupon",
                "activity_start_time": 1593985486,
                "activity_end_time": 1608480000
            }
        ],
        "schema": "{\"hotel_name\":\"北京大酒店\",\"hotel_addr\":\"北京西城区\",\"hotel_score\":\"4.7分\",\"hotel_star\":\"经济型酒店\"}"
    }
]

请求参数字段说明

参数类型是否必填描述示例值
pathstring智能小程序落地页链接/pages/detail/detail?id=100001
titlestring服务标题:描述服务是什么,12~30 个字符(汉字占 2 字符)美孚 1 号互联网定制款机油
descstring服务简介,服务的文字解释说明,8~34 个字符(汉字占 2 字符)修复半年若爆胎换新轮胎,低价保真
trade_typeint服务类目编码(参考附录一1001
imagesarray封面图片链接,目前只须传 1 张图片
图片要求
1.图片内容要求:
图片清晰、干净,不要出现令人不适的内容;不能出现严重影响用户理解的内容截断问题;图片无水印、二维码、logo;
2.相关性&一致性:
图片与标题、服务落地页内容相关、信息一致;单图片最大不能超 2M,只支持 JPG 或 PNG 格式
三种可选图片比例
a.正方形图片,比例 1:1,图片尺寸要求不低于 352 * 352
b.长方形横图,比例 16:9,图片尺寸不低于 1068 * 601
c.长方形竖图,比例 3:4,图片尺寸不低于 372 * 495
["https://b.bdstatic.com/miniapp/resource/image/demo1.png"]
regionstring服务地域(参考附录二),省市之间用英文中划线分割,多个地区之间用英文逗号分割示例 1:四川省-成都市,天津市
示例2:全国
price_infoobject服务价格,详见:price_info 字段说明{
"org_unit":"月",
"org_price":"880",
"real_price":"880"
}
tagstring服务的属性、亮点;最多三个标签;每个标签字数不超过 5 个汉字;不得出现特殊符号;"官方标"不可提交;多个标签使用英文封号分割可上楼;全国覆盖;24 小时营业
button_namestring服务按钮内的文案,表达使用服务的动作;字数为两个/四个汉字,推荐文案如下:咨询/立即咨询、问诊/立即问诊、预约/立即预约、预订/立即预订、办理/立即办理、购买/立即购买、购票/立即购票、抢票/立即抢票、订票/立即订票、下单/立即下单、抢购/立即抢购、团购/立即团购、入住/立即入住、查询/立即查询、查看/立即查看、排队/立即排队、进店/立即进店、租车/立即租车、租房/立即租房、充值/立即充值、缴费/立即缴费;如需新增,发邮件至ext_service_category@baidu.com,邮件正文请提供 APP key、小程序名称、页面标题、描述、落地页 path、新增按钮文案查询/立即查询
activity_infoarray优惠活动,详见:activity_info 字段说明[
  {
    "activity_type":"领券",
    "activity_desc":"满 10 减 2"
  }
]
schemastring行业扩展字段,trade_type=1001/1002/1004/5001/5003/7001/7002/7003/13001 时必须设置,详见:各个分类 schema 字段说明{"hotel_name":"北京大酒店","hotel_addr":"北京市","hotel_score":"4.7 分","hotel_star":"经济型酒店"}

price_info 对象字段说明

参数类型是否必填描述示例值
org_unitstring价格统一默认单位是「元」,提交价格字段时不必重复提交单位「元」,比如:98 元/月,价格字段提交 98、单位字段提交「月」;可选单位:小时、天、周、月、年、m²、m³、次、件;支持新增;如需新增,发邮件至smartapp-yylzd@baidu.com,邮件正文请提供 APP key、小程序名称、页面标题、描述、落地页 path、新增单位
org_pricestring优惠活动前的服务原价格90
real_pricestring当前服务的实际成交价格,精确价格与价格区间不同时出现88.8
range_min_pricestring当前服务的实际成交价格区间:最低价格800
range_max_pricestring当前服务的实际成交价格区间:最高价格900

activity_info 对象字段说明

参数类型是否必填描述示例值
activity_typestring优惠活动类型,默认值为优惠;不得出现特殊符号;可选文案:领券、红包、补贴、限免、特价、赠品、会员、拼团;如需新增,发邮件至 smartapp-yylzd@baidu.com,邮件正文请提供 APP key、小程序名称、页面标题、描述、落地页 path、新增活动类型领券
activity_descstring优惠活动说明,若优惠活动类型已填,则必填满 10 减 2
activity_pathstring优惠活动落地页链接,若优惠活动说明已填,则必填/pages/tabBar/index/index
activity_start_timeint优惠开始时间(时间戳到秒),不可早于提交时间,若优惠活动说明已填,则必填1592816447
activity_end_timeint优惠结束时间(时间戳到秒),距离开始时间不长于 6 个月,若优惠活动说明已填,则必填1592816447

返回字段说明

参数类型描述示例值
errnoint状态码40001
msgstring状态描述参数错误
datastring响应参数(如有提交失败的数据会返回失败的 path 和原因)--

请求示例

curl -X POST \
  'https://openapi.baidu.com/rest/2.0/smartapp/server/submit/sku?access_token=24.caba1534f826f164e61f142c642eca98.2592000.1595905348.282335-1788089' \
  -H 'Content-Type: application/json' \
  -d '[
    {
        "path": "/pages/detail/detail?id=100001",
        "trade_type": 5001,
        "title": "北京市北京大酒店",
        "desc": "北京大酒店欢迎您的光临",
        "images": [
            "https://mbs1.bdstatic.com/searchbox/mappconsole/image/20200623/90466909-d187-4a3e-a9ee-14ec842eae00.jpg"
        ],
        "region": "北京市",
        "price_info": {
            "org_unit": "天",
            "org_price": "300",
            "real_price": "200",
            "range_min_price": null,
            "range_max_price": null
        },
        "tag": "饮食健康;中餐",
        "button_name": "预订/立即预订",
        "activity_info": [
            {
                "activity_type": "领券",
                "activity_desc": "满10减2",
                "activity_path": "/activity/coupon",
                "activity_start_time": 1593985486,
                "activity_end_time": 1608480000
            }
        ],
        "schema": "{\"hotel_name\":\"北京大酒店\",\"hotel_addr\":\"北京西城区\",\"hotel_score\":\"4.7分\",\"hotel_star\":\"经济型酒店\"}"
    }
]'

返回值示例

{
  "errno":0,
  "msg":"success",
  "data":"{\"/pages/detail/detail?id=100001\":\"审核中资源禁止更新\"}"
}

3. 各分类 schema 字段说明

到店-电影(1001)

参数类型是否必填描述示例值
poi_infostringpoi 挂接信息(JSON 格式),详见:poi_info 字段说明-
movie_namestring电影影片名唐人街探案 3
movie_countrystring电影所属国家美国
movie_manstring主演周冬雨/彭于晏
movie_scorestring在映中或已下线电影的评分,当电影未上映时可不填,10 分制,保留小数点后一位9.7
visit_numint预售电影的想看人数,保留整数13739
movie_typestring电影所属类别,不同类别间以/分隔科幻/灾难/恐怖/悬疑
open_timestring电影上映时间(年-月-日)2018-12-30
movie_timestring电影时长104 分钟

poi_info 字段说明

参数类型是否必填描述示例值
poi_namestring商户名称老舍茶馆
poi_citystring城市名称北京市
poi_addrstring详细地址前门西大街正阳市场 3 号楼(国家供电局旁)
longitudestring经度,商户墨卡托坐标,精确到小数点后 6 位39.899679
latitudestring纬度,商户墨卡托坐标,精确到小数点后 6 位116.393279

到店-演出赛事(1002)

参数类型是否必填描述示例值
perform_namestring演出名2019 德云社龄龙相声专场 重庆站
perform_timestring演出时间2019-11-02 周六 19:30
perform_addrstring演出地点: 必须写清城市和具体地址重庆市人民大礼堂

到店-美食(1004)

参数类型是否必填描述示例值
poi_infostringpoi 挂接信息(JSON 格式),详见:poi_info 字段说明-
busi_statusint商户状态,0:下线 1:在线1
busi_typestring商铺所属分类日料
busi_starstring商铺星级,十分制8.3
busi_first_imagestring商户封面图,封面图像素大小不低于 558*372-
busi_door_imagestring商户门头图链接-
busi_image_liststring商户图片(JSON 格式),详见:busi_image_list 字段说明-
busi_avg_pricestring商铺人均价格200 元/人
busi_recommand_liststring商户推荐菜(JSON 格式),详见:busi_recommand_list 字段说明-
comment_liststring评论(JSON 格式),详见:comment_list 字段说明-

busi_image_list 字段说明

参数类型是否必填描述示例值
image_urlstring商户图片链接-
titlestring商户图片标题-
timestring商户图片添加时间-

busi_recommand_list 字段说明

参数类型是否必填描述示例值
namestring商户推荐菜名称海底捞自制滑牛肉
image_urlstring商户推荐菜图片链接-
pricestring商户推荐菜价格,保留整数36
numstring商户推荐菜被推荐次数,保留整数7408

comment_list 字段说明

参数类型是否必填描述示例值
nickstring评论人昵称办公室不舒服
photostring评论人头像-
starint评论星级,数字 0-5,对应 0-5 分,0-5 颗星4
contentstring评论内容保利剧院一层位置于地铁????2 号线东四十条站 B 口出步行 150 米!位置很好找!服务态度很好!就餐环境不错!比较典雅,适合商务聚餐,洽谈!推荐菜红烧牛????肉面????,口感不错,汤汁浓郁,肉质细腻!好吃!红糖玫...
image_liststring评论图片列表["http://www.baidu.com/1.png"]
timestring评论时间(时间戳到秒)1592816447
urlstring评论页 PATH7408

旅游出行-酒店(5001)

参数类型是否必填描述示例值
hotel_namestring酒店名称如家前门店
hotel_addrstring酒店地理位置信息,具体到城市北京西城区
hotel_scorestring酒店评分,5 分制4.7 分
hotel_starstring酒店星级经济型酒店

旅游出行-景点门票(5003)

参数类型是否必填描述示例值
poi_infostringpoi 挂接信息(JSON 格式),详见:poi_info 字段说明-
open_timestring景点开放时间4 月 1 日-10 月 31 日(旺季)周二到周日 08:30-17:00
scorestring景点评分,5 分制4.3 分
official_sitestring景点官方网站-
telephonestring景点电话-

房产-新房/二手房/房屋租赁(7001/7002/7003)

参数类型是否必填描述示例值
village_namestring小区或者楼盘名称融泽嘉园
addressstring地址,必须写清城市和具体地址重庆市人民大礼堂
areastring面积98m²

车主-汽车估值(13001)

参数类型是否必填描述示例值
brandstring品牌奥迪
car_seriesstring车系奥迪 Q2 2019 款

附录一:服务类目

编码类型二级类型二级类型简称
1001到店电影电影
1002到店演出赛事演出赛事
1003到店休闲娱乐(ktv/密室/按摩等)休闲娱乐
1004到店美食美食
1005到店亲子乐园亲子乐园
1006到店丽人丽人
1007到店美发美发
2001电商书籍书籍
2002电商服装佩饰服装佩饰
2003电商食品酒饮食品酒饮
2004电商生鲜生鲜
2005电商数码家电数码家电
2006电商母婴母婴
2007电商家居生活家居生活
2008电商美妆美妆
2009电商个护清洁个护清洁
2010电商奢侈品奢侈品
2011电商宠物用品宠物用品
3001充值缴费手机运营商服务手机运营商服务
3002充值缴费水电煤缴费水电煤缴费
3003充值缴费固话宽带固话宽带
3004充值缴费物业费物业费
4001投资理财信用卡业务信用卡业务
4002投资理财银行卡业务银行卡业务
4003投资理财保险保险
4004投资理财贷款贷款
5001旅游出行酒店酒店
5002旅游出行出行票务(飞机/火车/汽车/轮船等)出行票务
5003旅游出行景点门票景点门票
5004旅游出行线路游线路游
5005旅游出行签证签证
5006旅游出行租车租车
5007旅游出行打车打车
5008旅游出行值机值机
6001上门服务外卖外卖
6002上门服务拉货搬家拉货搬家
6003上门服务手机维修手机维修
6004上门服务电脑维修电脑维修
6005上门服务耳机维修耳机维修
6006上门服务手表维修手表维修
6007上门服务手机维修手机维修
6008上门服务家电维修家电维修
6009上门服务房屋维修房屋维修
6010上门服务家电清洗家电清洗
6011上门服务开锁换锁开锁换锁
6012上门服务管道疏通管道疏通
6013上门服务家政保洁家政保洁
6014上门服务上门回收上门回收
6015上门服务衣物洗护衣物洗护
6016上门服务改衣服务改衣服务
6017上门服务安装调试安装调试
6018上门服务美甲美容美甲美容
7001房产新房新房
7002房产二手房二手房
7003房产房屋租赁房屋租赁
7004房产装修装修
8001快递同城直送同城直送
8002快递上门取件上门取件
8003快递国际快递国际快递
9001医疗医生咨询医生咨询
9002医疗挂号挂号
9003医疗买药买药
9004医疗医美医美
9005医疗宠医宠医
10001法律法律咨询法律咨询
10002法律合同文书服务合同文书服务
10003法律律师函服务律师函服务
11001教育课程培训课程培训
11002教育教育咨询教育咨询
11003教育校园生活校园生活
12001招聘兼职招聘兼职招聘
12002招聘全职招聘全职招聘
12003招聘校园招聘校园招聘
13001车主汽车估值汽车估值
13002车主代驾代驾
13003车主交管服务(摇号/违章/驾照查分等)交管服务
13004车主维修保养维修保养
13005车主加油加油
13006车主停车停车
13007车主汽车用品汽车用品
13008车主etcetc

如需新增服务类目发邮件至ext_service_category@baidu.com,邮件正文请提供 APP key、小程序名称、页面标题、描述、落地页 path、新增类目(一级&二级)

附录二:服务地域

全国
上海市上海市
云南省临沧市
云南省丽江市
云南省保山市
云南省昆明市
云南省昭通市
云南省普洱市
云南省曲靖市
云南省玉溪市
北京市北京市
吉林省吉林市
吉林省四平市
吉林省松原市
吉林省白城市
吉林省白山市
吉林省辽源市
吉林省通化市
吉林省长春市
四川省乐山市
四川省内江市
四川省南充市
四川省宜宾市
四川省巴中市
四川省广元市
四川省广安市
四川省德阳市
四川省成都市
四川省泸州市
四川省眉山市
四川省绵阳市
四川省自贡市
四川省资阳市
四川省达州市
四川省遂宁市
四川省雅安市
天津市天津市
安徽省亳州市
安徽省六安市
安徽省合肥市
安徽省安庆市
安徽省宣城市
安徽省宿州市
安徽省池州市
安徽省淮北市
安徽省淮南市
安徽省滁州市
安徽省芜湖市
安徽省蚌埠市
安徽省铜陵市
安徽省阜阳市
安徽省黄山市
山东省东营市
山东省临沂市
山东省威海市
山东省德州市
山东省日照市
山东省枣庄市
山东省泰安市
山东省济南市
山东省济宁市
山东省淄博市
山东省滨州市
山东省潍坊市
山东省烟台市
山东省聊城市
山东省莱芜市
山东省菏泽市
山东省青岛市
山西省临汾市
山西省吕梁市
山西省大同市
山西省太原市
山西省忻州市
山西省晋中市
山西省晋城市
山西省朔州市
山西省运城市
山西省长治市
山西省阳泉市
广东省东莞市
广东省中山市
广东省云浮市
广东省佛山市
广东省广州市
广东省惠州市
广东省揭阳市
广东省梅州市
广东省汕头市
广东省汕尾市
广东省江门市
广东省河源市
广东省深圳市
广东省清远市
广东省湛江市
广东省潮州市
广东省珠海市
广东省肇庆市
广东省茂名市
广东省阳江市
广东省韶关市
江苏省南京市
江苏省南通市
江苏省宿迁市
江苏省常州市
江苏省徐州市
江苏省扬州市
江苏省无锡市
江苏省泰州市
江苏省淮安市
江苏省盐城市
江苏省苏州市
江苏省镇江市
江西省上饶市
江西省九江市
江西省南昌市
江西省吉安市
江西省宜春市
江西省抚州市
江西省新余市
江西省萍乡市
江西省赣州市
江西省鹰潭市
河北省保定市
河北省唐山市
河北省廊坊市
河北省承德市
河北省沧州市
河北省衡水市
河北省邢台市
河北省邯郸市
河南省信阳市
河南省南阳市
河南省周口市
河南省商丘市
河南省安阳市
河南省开封市
河南省新乡市
河南省洛阳市
河南省济源市
河南省漯河市
河南省濮阳市
河南省焦作市
河南省许昌市
河南省郑州市
河南省鹤壁市
浙江省丽水市
浙江省台州市
浙江省嘉兴市
浙江省宁波市
浙江省杭州市
浙江省温州市
浙江省湖州市
浙江省绍兴市
浙江省舟山市
浙江省衢州市
浙江省金华市
海南省三亚市
海南省海口市
湖北省十堰市
湖北省咸宁市
湖北省孝感市
湖北省宜昌市
湖北省武汉市
湖北省荆州市
湖北省荆门市
湖北省襄樊市
湖北省鄂州市
湖北省随州市
湖北省黄冈市
湖北省黄石市
湖南省娄底市
湖南省岳阳市
湖南省常德市
湖南省怀化市
湖南省株洲市
湖南省永州市
湖南省湘潭市
湖南省益阳市
湖南省衡阳市
湖南省邵阳市
湖南省郴州市
湖南省长沙市
甘肃省兰州市
甘肃省天水市
甘肃省定西市
甘肃省平凉市
甘肃省庆阳市
甘肃省张掖市
甘肃省武威市
甘肃省白银市
甘肃省酒泉市
甘肃省金昌市
甘肃省陇南市
福建省三明市
福建省南平市
福建省厦门市
福建省宁德市
福建省泉州市
福建省漳州市
福建省福州市
福建省莆田市
福建省龙岩市
贵州省安顺市
贵州省贵阳市
贵州省遵义市
辽宁省丹东市
辽宁省大连市
辽宁省抚顺市
辽宁省朝阳市
辽宁省本溪市
辽宁省沈阳市
辽宁省盘锦市
辽宁省营口市
辽宁省辽阳市
辽宁省铁岭市
辽宁省锦州市
辽宁省阜新市
辽宁省鞍山市
重庆市重庆市
陕西省咸阳市
陕西省商洛市
陕西省安康市
陕西省宝鸡市
陕西省延安市
陕西省杨陵区
陕西省榆林市
陕西省汉中市
陕西省渭南市
陕西省西安市
陕西省铜川市
陕西省韩城市
青海省西宁市
四川省攀枝花市
安徽省马鞍山市
江苏省连云港市
江西省景德镇市
河北省张家口市
河北省石家庄市
河北省秦皇岛市
河南省三门峡市
河南省平顶山市
河南省驻马店市
湖南省张家界市
甘肃省嘉峪关市
贵州省六盘水市
贵州省毕节地区
贵州省铜仁地区
辽宁省葫芦岛市
青海省海东地区
云南省大理白族自治州
云南省楚雄彝族自治州
云南省迪庆藏族自治州
四川省凉山彝族自治州
四川省甘孜藏族自治州
甘肃省临夏回族自治州
甘肃省甘南藏族自治州
青海省果洛藏族自治州
青海省海北藏族自治州
青海省海南藏族自治州
青海省玉树藏族自治州
青海省黄南藏族自治州
云南省怒江傈僳族自治州
吉林省延边朝鲜族自治州
云南省文山壮族苗族自治州
云南省西双版纳傣族自治州
四川省阿坝藏族羌族自治州
海南省省直辖县级行政单位
湖北省省直辖县级行政区划
云南省德宏傣族景颇族自治州
云南省红河哈尼族彝族自治州
湖北省恩施土家族苗族自治州
湖南省湘西土家族苗族自治州
贵州省黔东南苗族侗族自治州
贵州省黔南布依族苗族自治州
青海省海西蒙古族藏族自治州
贵州省黔西南布依族苗族自治州
黑龙江省伊春市
黑龙江省大庆市
黑龙江省绥化市
黑龙江省鸡西市
黑龙江省鹤岗市
黑龙江省黑河市
黑龙江省七台河市
黑龙江省佳木斯市
黑龙江省双鸭山市
黑龙江省哈尔滨市
黑龙江省牡丹江市
黑龙江省齐齐哈尔市
黑龙江省大兴安岭地区
西藏自治区拉萨市
西藏自治区山南地区
西藏自治区昌都地区
西藏自治区林芝地区
西藏自治区那曲地区
西藏自治区阿里地区
西藏自治区日喀则地区
内蒙古自治区乌海市
内蒙古自治区兴安盟
内蒙古自治区包头市
内蒙古自治区赤峰市
内蒙古自治区通辽市
内蒙古自治区阿拉善盟
内蒙古自治区乌兰察布市
内蒙古自治区呼伦贝尔市
内蒙古自治区呼和浩特市
内蒙古自治区巴彦淖尔市
内蒙古自治区鄂尔多斯市
内蒙古自治区锡林郭勒盟
宁夏回族自治区中卫市
宁夏回族自治区吴忠市
宁夏回族自治区固原市
宁夏回族自治区银川市
广西壮族自治区北海市
广西壮族自治区南宁市
广西壮族自治区崇左市
广西壮族自治区来宾市
广西壮族自治区柳州市
广西壮族自治区桂林市
广西壮族自治区梧州市
广西壮族自治区河池市
广西壮族自治区玉林市
广西壮族自治区百色市
广西壮族自治区贵港市
广西壮族自治区贺州市
广西壮族自治区钦州市
宁夏回族自治区石嘴山市
广西壮族自治区防城港市
新疆维吾尔自治区和田地区
新疆维吾尔自治区哈密地区
新疆维吾尔自治区喀什地区
新疆维吾尔自治区塔城地区
新疆维吾尔自治区乌鲁木齐市
新疆维吾尔自治区克拉玛依市
新疆维吾尔自治区吐鲁番地区
新疆维吾尔自治区阿克苏地区
新疆维吾尔自治区阿勒泰地区
新疆维吾尔自治区昌吉回族自治州
新疆维吾尔自治区伊犁哈萨克自治州
新疆维吾尔自治区博尔塔拉蒙古自治州
新疆维吾尔自治区巴音郭楞蒙古自治州
新疆维吾尔自治区克孜勒苏柯尔克孜自治州
新疆维吾尔自治区自治区直辖县级行政单位


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号