商品接口 | 微信开放文档

# 商品接口

接口名称	说明
获取联盟商品类目列表及类目ID	支持开发者通过该接口获取联盟商品的一级类目列表以及类目ID
查询全量商品	支持开发者通过获取联盟全量商品的信息（单次最多获取50个商品），支持根据商品关键词（名称、店铺、spuID）、商品价格、商品佣金、佣金比例、是否有联盟券进行筛选
查询联盟精选商品	支持开发者获取联盟精选商品的信息（单次最多获取50个商品），支持根据商品价格、商品佣金、佣金比例、是否有联盟券进行筛选
获取商品推广素材	通过该接口获取商品的推广素材，包括店铺appID、商品详情页Path、推广文案及推广短链、商品图片等

# 1.获取联盟商品类目列表及类目ID

# 接口说明

通过该接口获取联盟商品的一级类目列表以及类目ID，可用于筛选联盟商品

# 请求地址

GET https://api.weixin.qq.com/union/promoter/product/category?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证

# 返回值

# Object

返回的 JSON 数据包

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
productCats	Array.<Object>	类目数据

productCats 的结构

属性	类型	说明
catId	string	类目ID
name	string	类目名称

# 返回示例

{
  "errcode": 0,
  "productCats": [
    {
      "catId": "1234",
      "name": "家纺"
    },
    {
      "catId": "1235",
      "name": "家具"
    },
    {
      "catId": "1236",
      "name": "母婴"
    },
  ]
}

# 2.查询全量商品

# 接口说明

支持开发者根据多种筛选条件获取可供推广的商品列表及详情，筛选条件包括商品关键词（名称、店铺、spuID）、商品累计销量、商品价格、商品佣金、佣金比例、是否含有联盟券、配送方式、发货地区等

# 请求地址

GET https://api.weixin.qq.com/union/promoter/product/list?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
from	string		是	偏移，从0开始
limit	string		是	每页条数
query	string		否	搜索关键词，具体含义与`queryType`相关
queryType	number	0	否	搜索类型
maxPrice	number		否	商品最高价格，单位分
minPrice	number	0	否	商品最低价格，单位分
minCommissionValue	number	0	否	佣金金额下限，单位分
minCommissionRatio	number	0	否	佣金比例下限，单位万分之一
sortType	number	0	否
categoryId	number		否	单个类目ID，值来自`获取类目列表接口`
shopAppIds	Array.<string>		否	小商店`AppID`列表
hasCoupon	number	0	否	是否有联盟券,1为含券商品，0为全部商品
category	string		否	多个类目ID，多个用英文逗号分隔。若与categoryid同时存在，取categoryid
noCategory	string		否	黑名单类目ID，不拉出黑名单类目商品，多个用英文逗号分隔
productId	string		否	商品SPUID，多个用英文逗号分隔
shippingMethods	string		否	配送方式，JSON对象字符串，具体结构见`shippingMethods 的结构`
addressList	string		否	发货地址列表，JSON数组字符串，单个结构见`address`

queryType 的枚举

值	类型	说明
0	number	搜索商品名称
1	number	搜索小商店名称
2	number	搜索商品SPU ID

sortType 的枚举

值	类型	说明
0	number	默认排序
1	number	商品价格升序
2	number	商品价格降序
3	number	佣金比例升序
4	number	佣金比例降序
5	number	佣金数值升序
6	number	佣金数值降序
7	number	销量数值升序
8	number	销量数值降序

shippingMethods 的结构

属性	类型	说明
express	number	是否支持快递，1：是，0：否
sameCity	number	是否支持同城配送，1：是，0：否
pickup	number	是否支持上门自提，1：是，0：否

address 的结构

属性	类型	说明
addressInfo	Object	地址信息
addressType	Object	地址类型，结构同 shippingMethods

addressInfo 的结构

属性	类型	说明
provinceName	string	国标收货地址第一级地址
cityName	string	国标收货地址第二级地址
countyName	string	国标收货地址第三级地址

# 返回值

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
total	number	商品总数
productList	Array.<Object>	商品列表数据

productList 的结构

属性	类型	说明
productId	string	商品SPU ID
product	Object	商品数据
leagueExInfo	Object	联盟佣金相关数据
shopInfo	Object	商品所属小商店数据
couponInfo	Object	联盟优惠券数据

product 的结构

属性	类型	说明
productId	string	商品SPU ID
info	Object	商品具体信息
info.title	string	商品标题
info.subTitle	string	商品子标题
info.headImg	Array.<string>	商品主图
info.category	Array.<string>	商品类目
info.category[].catId	Object	类目ID
info.category[].name	Object	类目名称
info.brand	string	品牌名称
info.brandId	string	品牌ID
info.model	string	型号
info.detail	Object	商品详细数据
info.detail.detailImg	Array.<string>	商品详情图片
info.param	Array.<Object>	商品参数
info.minPrice	number	商品最低价格，单位分
info.totalStockNum	number	总库存
info.totalSoldNum	number	累计销量
info.totalOrderNum	number	累计订单量
info.discountPrice	number	商品券后价
skus	Array.<Object>	商品SKU
skus[].skuId	string	商品SKU ID
skus[].productSkuInfo.thumbImg	string	商品SKU 小图
skus[].productSkuInfo.salePrice	Object	商品SKU 销售价格，单位分
skus[].productSkuInfo.marketPrice	Object	商品SKU 市场价格，单位分
skus[].productSkuInfo.stockInfo.stockNum	number	商品SKU 库存

leagueExInfo 的结构

属性	类型	说明
hasCommission	number	是否有佣金，1/0
commissionRatio	number	佣金比例，万分之一
commissionValue	number	佣金金额，单位分

shopInfo 的结构

属性	类型	说明
name	string	小商店名称
appId	string	小商店`AppID`
username	string	小商店原始id
headImgUrl	string	小商店店铺头像
shippingMethods	Object	配送方式，结构见`shippingMethods 的结构`
addressList	Array.<address>	发货地，只有当配送方式包含「同城配送、上门自提」才出该项
sameCityTemplate	Object	配送范围，只有当配送方式包含「同城配送」才出该项
freightTemplate	Object	运费模板，只有当配送方式包含「快递」才出此项

couponInfo 的结构

属性	类型	说明
hasCoupon	number	是否有联盟券，1为含券商品，0为全部商品
couponId	string	券id
couponDetail	Object	券详情

couponDetail 的结构

属性	类型	说明
restNum	number	券库存
type	number	券类型
discountInfo	Object	券面额
validInfo	Object	有效期
receiveInfo	Object	领券时间

discountInfo 的结构

属性	类型	说明
discountCondition.productIds[]	string	指定商品 id
discountCondition.productCnt	number	商品数
discountCondition.productPrice	number	商品金额
discountNum	number	折扣数，如 5.1 折为 5.1 * 1000
discountFee	number	直减金额，单位为分

validInfo 的结构

属性	类型	说明
validType	number	有效期类型，1 为商品指定时间区间，2 为生效天数
validDayNum	number	生效天数
startTime	string	有效开始时间
endTime	string	有效结束时间

receiveInfo 的结构

属性	类型	说明
startTime	string	领取开始时间戳
endTime	string	领取结束时间戳
limitNumOnePerson	number	每人限领张数

sameCityTemplate 的结构

属性	类型	说明
deliverScopeType	number	配送范围的定义方式，0：按照距离定义配送范围，1：按照区域定义配送范围
scope	string	配送范围
region	Object	全城配送时的配送范围，结构同`addressInfo`

freightTemplate 的结构

属性	类型	说明
notSendArea	Object	不发货地区

notSendArea 的结构

属性	类型	说明
addressInfoList	Array.<addressInfo>	不发货地区地址列表

# 返回示例

{
    "errcode": 0,
    "errmsg": "",
    "productList": [
        {
            "productId": "7554942",
            "product": {
                "productId": "7554942",
                "status": 5,
                "info": {
                    "title": "新增商品并保存case_UpProduct",
                    "subTitle": "这是商品子标题",
                    "headImg": [
                        "https://wxamusic.wx.qq.com/wxasr/getminipic/zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde?media-id=zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde&amp;appid=wx678687fa5226e237"
                    ],
                    "category": [
                        {
                            "catId": "1247",
                            "name": "家具",
                            "fCatId": "0",
                            "updateTime": "0",
                            "catType": 1,
                            "bizuin": "3845180796",
                            "brandCat": "9223372036854775807",
                            "catInfo": {
                                "isRequired": 0,
                                "isCustomize": 0,
                                "catLevel": 1
                            },
                            "auditId": "0",
                            "desc": "",
                            "priority": 0
                        },
                        {
                            "catId": "1267",
                            "name": "儿童家具",
                            "fCatId": "1247",
                            "catType": 1,
                            "version": 0,
                            "bizuin": "0",
                            "catInfo": {
                                "isRequired": 0,
                                "isCustomize": 0,
                                "catLevel": 2
                            },
                            "auditId": "0",
                            "desc": "",
                            "priority": 0
                        },
                        {
                            "catId": "1270",
                            "name": "儿童床",
                            "fCatId": "1267",
                            "createTime": "0",
                            "updateTime": "0",
                            "catType": 1,
                            "version": 0,
                            "bizuin": "0",
                            "brandCat": "9223372036854775807",
                            "catInfo": {
                                "isRequired": 0,
                                "isCustomize": 0,
                                "specType": 0,
                                "specTypeDesc": "",
                                "attrTemplateId": "0",
                                "attrTemplateName": "",
                                "maxAttrNum": 18,
                                "editByUser": 0,
                                "catLevel": 3,
                                "highestPriceFixing": 0,
                                "wording": "",
                                "description": "",
                                "maxProductNum": 0,
                                "qualification": "",
                                "productQualification": "",
                                "quaNeedAudit": "",
                                "maxQualificationImg": 0,
                                "catGroup": 0,
                                "individualAuditInfo": {
                                    "qualification": "",
                                    "productQualification": "",
                                    "quaNeedAudit": "",
                                    "maxQualificationImg": 0
                                },
                                "enterpriseAuditInfo": {
                                    "qualification": "",
                                    "productQualification": "",
                                    "quaNeedAudit": "",
                                    "maxQualificationImg": 0
                                }
                            },
                            "auditId": "0",
                            "desc": "",
                            "priority": 0
                        }
                    ],
                    "brand": "",
                    "brandId": "2100000000",
                    "model": "",
                    "detail": {
                        "detailImg": [
                            "https://wxamusic.wx.qq.com/wxasr/getminipic/zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde?media-id=zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde&amp;appid=wx678687fa5226e237"
                        ],
                        "detailVideos": [],
                        "detailVideoInfo": []
                    },
                    "param": [],
                    "minPrice": 2000,
                    "expressInfo": {
                        "templateId": "37927"
                    },
                    "totalStockNum": 0
                },
                "skus": []
            },
            "leagueExInfo": {
                "hasCommission": 1,
                "commissionRatio": 8000,
                "commissionValue": 1600
            },
            "shopInfo": {
                "name": "猪腩肉小商店",
                "guaranteeFlag": 0,
                "headImgUrl": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM77ia7ibuPAQBJgME8gFF9APicaSpd7evrLCVb5hn2zsUBOw"
            }
        },
        {
            "productId": "6565746",
            "product": {
                "productId": "6565746",
                "status": 5,
                "info": {
                    "title": "测试假发",
                    "subTitle": "测试假发",
                    "headImg": [
                        "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/5fd316dc0000ef4b0000000043785609000000a000004f50"
                    ],
                    "category": [
                        {
                            "catId": "1001",
                            "name": ""
                        },
                        {
                            "catId": "1030",
                            "name": ""
                        },
                        {
                            "catId": "1031",
                            "name": ""
                        }
                    ],
                    "brandId": "2100000000",
                    "detail": {
                        "detailImg": [],
                        "detailVideos": [],
                        "detailVideoInfo": [],
                        "desc": "测试商品"
                    },
                    "param": [],
                    "minPrice": 100,
                    "expressInfo": {
                        "templateId": "1024691"
                    },
                    "totalStockNum": 39995
                },
                "skus": [
                    {
                        "skuId": "11913889",
                        "status": 5,
                        "productSkuInfo": {
                            "saleParam": [
                                {
                                    "categorys": [
                                        {
                                            "catId": "35245",
                                            "name": "选择产品",
                                            "fCatId": "1031",
                                            "catType": 3,
                                            "bizuin": "3853210889",
                                            "brandCat": "0",
                                            "catInfo": {
                                                "isCustomize": 1,
                                                "editByUser": 0
                                            },
                                            "desc": "",
                                            "priority": 0
                                        },
                                        {
                                            "catId": "1000000000000",
                                            "name": "111",
                                            "fCatId": "35245",
                                            "bizuin": "3853210889",
                                            "catInfo": {
                                                "editByUser": 1
                                            },
                                            "desc": "",
                                            "priority": 1
                                        }
                                    ]
                                },
                                {
                                    "categorys": [
                                        {
                                            "catId": "35246",
                                            "name": "选择颜色",
                                            "fCatId": "1031",
                                            "catType": 3,
                                            "bizuin": "3853210889",
                                            "brandCat": "0",
                                            "catInfo": {
                                                "isCustomize": 1,
                                                "editByUser": 0
                                            },
                                            "desc": "",
                                            "priority": 0
                                        },
                                        {
                                            "catId": "1000000000001",
                                            "name": "3333",
                                            "fCatId": "35246",
                                            "bizuin": "3853210889",
                                            "catInfo": {
                                                "editByUser": 1
                                            },
                                            "desc": "",
                                            "priority": 1
                                        }
                                    ]
                                }
                            ],
                            "thumbImg": "",
                            "skuCode": "",
                            "salePrice": 100,
                            "marketPrice": 100,
                            "stockInfo": {
                                "stockNum": 20000
                            },
                            "appidForMedia": ""
                        }
                    },
                    {
                        "skuId": "11915862",
                        "status": 5,
                        "productSkuInfo": {
                            "saleParam": [
                                {
                                    "categorys": [
                                        {
                                            "catId": "35245",
                                            "name": "选择产品",
                                            "fCatId": "1031",
                                            "catType": 3,
                                            "bizuin": "3853210889",
                                            "brandCat": "0",
                                            "catInfo": {
                                                "isCustomize": 1,
                                                "editByUser": 0
                                            },
                                            "desc": "",
                                            "priority": 0
                                        },
                                        {
                                            "catId": "1000000000002",
                                            "name": "1112",
                                            "fCatId": "35245",
                                            "bizuin": "3853210889",
                                            "catInfo": {
                                                "editByUser": 1
                                            },
                                            "desc": "",
                                            "priority": 2
                                        }
                                    ]
                                },
                                {
                                    "categorys": [
                                        {
                                            "catId": "35246",
                                            "name": "选择颜色",
                                            "fCatId": "1031",
                                            "catType": 3,
                                            "bizuin": "3853210889",
                                            "brandCat": "0",
                                            "catInfo": {
                                                "isCustomize": 1,
                                                "editByUser": 0
                                            },
                                            "desc": "",
                                            "priority": 0
                                        },
                                        {
                                            "catId": "1000000000001",
                                            "name": "3333",
                                            "fCatId": "35246",
                                            "bizuin": "3853210889",
                                            "catInfo": {
                                                "editByUser": 1
                                            },
                                            "desc": "",
                                            "priority": 1
                                        }
                                    ]
                                }
                            ],
                            "thumbImg": "",
                            "skuCode": "",
                            "salePrice": 100,
                            "marketPrice": 100,
                            "stockInfo": {
                                "stockNum": 20000
                            },
                            "appidForMedia": ""
                        }
                    }
                ]
            },
            "leagueExInfo": {
                "hasCommission": 1,
                "commissionRatio": 3300,
                "commissionValue": 33
            },
            "shopInfo": {
                "name": "沅沅小可爱",
                "guaranteeFlag": 0,
                "headImgUrl": "http://wx.qlogo.cn/mmhead/574VdhMFwaETvsGUwOpJsHAWaM3UDznibq3MMMiaOPSt7Ir1ecTLOfJQ/0"
            }
        }
    ],
    "total": 100
}

# 3.查询联盟精选商品

# 接口说明

支持开发者根据多种筛选条件获取联盟精选的商品列表及详情，筛选条件包括商品价格、商品佣金、商品累计销量、佣金比例、是否含有联盟券、配送方式、发货地区

# 请求地址

GET https://api.weixin.qq.com/union/promoter/product/select?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
from	string		是	偏移，从0开始
limit	string		是	每页条数
maxPrice	number		否	商品最高价格，单位分
minPrice	number	0	否	商品最低价格，单位分
minCommissionValue	number	0	否	佣金金额下限，单位分
minCommissionRatio	number	0	否	佣金比例下限，单位万分之一
sortType	number	0	否
categoryId	number		否	单个类目ID，值来自`获取类目列表接口`
shopAppIds	Array.<string>		否	小商店`AppID`列表
hasCoupon	number	0	否	是否有联盟券,1为含券商品，0为全部商品
category	string		否	多个类目ID，多个用英文逗号分隔。若与categoryid同时存在，取categoryid
noCategory	string		否	黑名单类目ID，不拉出黑名单类目商品，多个用英文逗号分隔
productId	string		否	商品SPUID，多个用英文逗号分隔
shippingMethods	string		否	配送方式，JSON对象字符串，具体结构见`shippingMethods 的结构`
addressList	string		否	发货地址列表，JSON数组字符串，单个结构见`address`

sortType 的枚举

值	类型	说明
0	number	默认排序
1	number	商品价格升序
2	number	商品价格降序
3	number	佣金比例升序
4	number	佣金比例降序
5	number	佣金数值升序
6	number	佣金数值降序
7	number	销量数值升序
8	number	销量数值降序

shippingMethods 的结构

属性	类型	说明
express	number	是否支持快递，1：是，0：否
sameCity	number	是否支持同城配送，1：是，0：否
pickup	number	是否支持上门自提，1：是，0：否

address 的结构

属性	类型	说明
addressInfo	Object	地址信息
addressType	Object	地址类型，结构同 shippingMethods

addressInfo 的结构

属性	类型	说明
provinceName	string	国标收货地址第一级地址
cityName	string	国标收货地址第二级地址
countyName	string	国标收货地址第三级地址

# 返回值

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
total	number	商品总数
productList	Array.<Object>	商品列表数据

productList 的结构

属性	类型	说明
productId	string	商品SPU ID
product	Object	商品数据
leagueExInfo	Object	联盟佣金相关数据
shopInfo	Object	商品所属小商店数据
couponInfo	Object	联盟优惠券数据

product 的结构

属性	类型	说明
productId	string	商品SPU ID
info	Object	商品具体信息
info.title	string	商品标题
info.subTitle	string	商品子标题
info.headImg	Array.<string>	商品主图
info.category	Array.<string>	商品类目
info.category[].catId	Object	类目ID
info.category[].name	Object	类目名称
info.brand	string	品牌名称
info.brandId	string	品牌ID
info.model	string	型号
info.detail	Object	商品详细数据
info.detail.detailImg	Array.<string>	商品详情图片
info.param	Array.<Object>	商品参数
info.minPrice	number	商品最低价格，单位分
info.totalStockNum	number	总库存
info.totalSoldNum	number	累计销量
info.totalOrderNum	number	累计订单量
info.discountPrice	number	商品券后价
skus	Array.<Object>	商品SKU
skus[].skuId	string	商品SKU ID
skus[].productSkuInfo.thumbImg	string	商品SKU 小图
skus[].productSkuInfo.salePrice	Object	商品SKU 销售价格，单位分
skus[].productSkuInfo.marketPrice	Object	商品SKU 市场价格，单位分
skus[].productSkuInfo.stockInfo.stockNum	number	商品SKU 库存

leagueExInfo 的结构

属性	类型	说明
hasCommission	number	是否有佣金，1/0
commissionRatio	number	佣金比例，万分之一
commissionValue	number	佣金金额，单位分

shopInfo 的结构

属性	类型	说明
name	number	小商店名称
appId	string	小商店`AppID`
username	string	小商店原始id
headImgUrl	string	小商店店铺头像
shippingMethods	Object	配送方式，结构见`shippingMethods 的结构`
addressList	Array.<address>	发货地，只有当配送方式包含「同城配送、上门自提」才出该项
sameCityTemplate	Object	配送范围，只有当配送方式包含「同城配送」才出该项
freightTemplate	Object	运费模板，只有当配送方式包含「快递」才出此项

couponInfo 的结构

属性	类型	说明
hasCoupon	number	是否有联盟券，1为含券商品，0为全部商品
couponId	string	券id
couponDetail	Object	券详情

couponDetail 的结构

属性	类型	说明
restNum	number	券库存
type	number	券类型
discountInfo	Object	券面额
validInfo	Object	有效期
receiveInfo	Object	领券时间

discountInfo 的结构

属性	类型	说明
discountCondition.productIds[]	string	指定商品 id
discountCondition.productCnt	number	商品数
discountCondition.productPrice	number	商品金额
discountNum	number	折扣数，如 5.1 折为 5.1 * 1000
discountFee	number	直减金额，单位为分

validInfo 的结构

属性	类型	说明
validType	number	有效期类型，1 为商品指定时间区间，2 为生效天数
validDayNum	number	生效天数
startTime	string	有效开始时间
endTime	string	有效结束时间

receiveInfo 的结构

属性	类型	说明
startTime	string	领取开始时间戳
endTime	string	领取结束时间戳
limitNumOnePerson	number	每人限领张数

sameCityTemplate 的结构

属性	类型	说明
deliverScopeType	number	配送范围的定义方式，0：按照距离定义配送范围，1：按照区域定义配送范围
scope	string	配送范围
region	Object	全城配送时的配送范围，结构同`addressInfo`

freightTemplate 的结构

属性	类型	说明
notSendArea	Object	不发货地区

notSendArea 的结构

属性	类型	说明
addressInfoList	Array.<addressInfo>	不发货地区地址列表

# 返回示例

{
    "errcode": 0,
    "errmsg": "",
    "productList": [
        {
            "productId": "7554942",
            "product": {
                "productId": "7554942",
                "status": 5,
                "info": {
                    "title": "新增商品并保存case_UpProduct",
                    "subTitle": "这是商品子标题",
                    "headImg": [
                        "https://wxamusic.wx.qq.com/wxasr/getminipic/zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde?media-id=zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde&amp;appid=wx678687fa5226e237"
                    ],
                    "category": [
                        {
                            "catId": "1247",
                            "name": "家具",
                            "fCatId": "0",
                            "updateTime": "0",
                            "catType": 1,
                            "bizuin": "3845180796",
                            "brandCat": "9223372036854775807",
                            "catInfo": {
                                "isRequired": 0,
                                "isCustomize": 0,
                                "catLevel": 1
                            },
                            "auditId": "0",
                            "desc": "",
                            "priority": 0
                        },
                        {
                            "catId": "1267",
                            "name": "儿童家具",
                            "fCatId": "1247",
                            "catType": 1,
                            "version": 0,
                            "bizuin": "0",
                            "catInfo": {
                                "isRequired": 0,
                                "isCustomize": 0,
                                "catLevel": 2
                            },
                            "auditId": "0",
                            "desc": "",
                            "priority": 0
                        },
                        {
                            "catId": "1270",
                            "name": "儿童床",
                            "fCatId": "1267",
                            "createTime": "0",
                            "updateTime": "0",
                            "catType": 1,
                            "version": 0,
                            "bizuin": "0",
                            "brandCat": "9223372036854775807",
                            "catInfo": {
                                "isRequired": 0,
                                "isCustomize": 0,
                                "specType": 0,
                                "specTypeDesc": "",
                                "attrTemplateId": "0",
                                "attrTemplateName": "",
                                "maxAttrNum": 18,
                                "editByUser": 0,
                                "catLevel": 3,
                                "highestPriceFixing": 0,
                                "wording": "",
                                "description": "",
                                "maxProductNum": 0,
                                "qualification": "",
                                "productQualification": "",
                                "quaNeedAudit": "",
                                "maxQualificationImg": 0,
                                "catGroup": 0,
                                "individualAuditInfo": {
                                    "qualification": "",
                                    "productQualification": "",
                                    "quaNeedAudit": "",
                                    "maxQualificationImg": 0
                                },
                                "enterpriseAuditInfo": {
                                    "qualification": "",
                                    "productQualification": "",
                                    "quaNeedAudit": "",
                                    "maxQualificationImg": 0
                                }
                            },
                            "auditId": "0",
                            "desc": "",
                            "priority": 0
                        }
                    ],
                    "brand": "",
                    "brandId": "2100000000",
                    "model": "",
                    "detail": {
                        "detailImg": [
                            "https://wxamusic.wx.qq.com/wxasr/getminipic/zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde?media-id=zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde&amp;appid=wx678687fa5226e237"
                        ],
                        "detailVideos": [],
                        "detailVideoInfo": []
                    },
                    "param": [],
                    "minPrice": 2000,
                    "expressInfo": {
                        "templateId": "37927"
                    },
                    "totalStockNum": 0
                },
                "skus": []
            },
            "leagueExInfo": {
                "hasCommission": 1,
                "commissionRatio": 8000,
                "commissionValue": 1600
            },
            "shopInfo": {
                "name": "猪腩肉小商店",
                "guaranteeFlag": 0,
                "headImgUrl": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM77ia7ibuPAQBJgME8gFF9APicaSpd7evrLCVb5hn2zsUBOw"
            }
        },
        {
            "productId": "6565746",
            "product": {
                "productId": "6565746",
                "status": 5,
                "info": {
                    "title": "测试假发",
                    "subTitle": "测试假发",
                    "headImg": [
                        "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/5fd316dc0000ef4b0000000043785609000000a000004f50"
                    ],
                    "category": [
                        {
                            "catId": "1001",
                            "name": ""
                        },
                        {
                            "catId": "1030",
                            "name": ""
                        },
                        {
                            "catId": "1031",
                            "name": ""
                        }
                    ],
                    "brandId": "2100000000",
                    "detail": {
                        "detailImg": [],
                        "detailVideos": [],
                        "detailVideoInfo": [],
                        "desc": "测试商品"
                    },
                    "param": [],
                    "minPrice": 100,
                    "expressInfo": {
                        "templateId": "1024691"
                    },
                    "totalStockNum": 39995
                },
                "skus": [
                    {
                        "skuId": "11913889",
                        "status": 5,
                        "productSkuInfo": {
                            "saleParam": [
                                {
                                    "categorys": [
                                        {
                                            "catId": "35245",
                                            "name": "选择产品",
                                            "fCatId": "1031",
                                            "catType": 3,
                                            "bizuin": "3853210889",
                                            "brandCat": "0",
                                            "catInfo": {
                                                "isCustomize": 1,
                                                "editByUser": 0
                                            },
                                            "desc": "",
                                            "priority": 0
                                        },
                                        {
                                            "catId": "1000000000000",
                                            "name": "111",
                                            "fCatId": "35245",
                                            "bizuin": "3853210889",
                                            "catInfo": {
                                                "editByUser": 1
                                            },
                                            "desc": "",
                                            "priority": 1
                                        }
                                    ]
                                },
                                {
                                    "categorys": [
                                        {
                                            "catId": "35246",
                                            "name": "选择颜色",
                                            "fCatId": "1031",
                                            "catType": 3,
                                            "bizuin": "3853210889",
                                            "brandCat": "0",
                                            "catInfo": {
                                                "isCustomize": 1,
                                                "editByUser": 0
                                            },
                                            "desc": "",
                                            "priority": 0
                                        },
                                        {
                                            "catId": "1000000000001",
                                            "name": "3333",
                                            "fCatId": "35246",
                                            "bizuin": "3853210889",
                                            "catInfo": {
                                                "editByUser": 1
                                            },
                                            "desc": "",
                                            "priority": 1
                                        }
                                    ]
                                }
                            ],
                            "thumbImg": "",
                            "skuCode": "",
                            "salePrice": 100,
                            "marketPrice": 100,
                            "stockInfo": {
                                "stockNum": 20000
                            },
                            "appidForMedia": ""
                        }
                    },
                    {
                        "skuId": "11915862",
                        "status": 5,
                        "productSkuInfo": {
                            "saleParam": [
                                {
                                    "categorys": [
                                        {
                                            "catId": "35245",
                                            "name": "选择产品",
                                            "fCatId": "1031",
                                            "catType": 3,
                                            "bizuin": "3853210889",
                                            "brandCat": "0",
                                            "catInfo": {
                                                "isCustomize": 1,
                                                "editByUser": 0
                                            },
                                            "desc": "",
                                            "priority": 0
                                        },
                                        {
                                            "catId": "1000000000002",
                                            "name": "1112",
                                            "fCatId": "35245",
                                            "bizuin": "3853210889",
                                            "catInfo": {
                                                "editByUser": 1
                                            },
                                            "desc": "",
                                            "priority": 2
                                        }
                                    ]
                                },
                                {
                                    "categorys": [
                                        {
                                            "catId": "35246",
                                            "name": "选择颜色",
                                            "fCatId": "1031",
                                            "catType": 3,
                                            "bizuin": "3853210889",
                                            "brandCat": "0",
                                            "catInfo": {
                                                "isCustomize": 1,
                                                "editByUser": 0
                                            },
                                            "desc": "",
                                            "priority": 0
                                        },
                                        {
                                            "catId": "1000000000001",
                                            "name": "3333",
                                            "fCatId": "35246",
                                            "bizuin": "3853210889",
                                            "catInfo": {
                                                "editByUser": 1
                                            },
                                            "desc": "",
                                            "priority": 1
                                        }
                                    ]
                                }
                            ],
                            "thumbImg": "",
                            "skuCode": "",
                            "salePrice": 100,
                            "marketPrice": 100,
                            "stockInfo": {
                                "stockNum": 20000
                            },
                            "appidForMedia": ""
                        }
                    }
                ]
            },
            "leagueExInfo": {
                "hasCommission": 1,
                "commissionRatio": 3300,
                "commissionValue": 33
            },
            "shopInfo": {
                "name": "沅沅小可爱",
                "guaranteeFlag": 0,
                "headImgUrl": "http://wx.qlogo.cn/mmhead/574VdhMFwaETvsGUwOpJsHAWaM3UDznibq3MMMiaOPSt7Ir1ecTLOfJQ/0"
            }
        }
    ],
    "total": 100
}

# 4.获取商品推广素材

# 接口说明

通过该接口获取商品的推广素材，包括店铺appID、商品详情页Path、推广文案及推广短链、商品图片等

# 请求地址

POST https://api.weixin.qq.com/union/promoter/product/generate?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
pid	string	是	推广位PID
productList	Array.<Object>	是	商品列表
productList[].productId	string	是	商品SPU ID
productList[].appId	string	是	商品所在小商店的AppID
productList[].customizeInfo	string	否	自定义参数，最多包含80个字符

# POST示例

{
  "pid": "oUnIc49zinb1mtlfB5K-NfGJxxNE_341161518",
  "productList": [
    {
      "productId": "14495788",
      "appId": "wxb82530c28"
    }
  ]
}

# 返回值

# Object

返回的 JSON 数据包

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
list	Array.<Object>
list[].productId	string	商品SPU ID
list[].pid	string	推广位PID
list[].productInfo	Object	商品相关信息
list[].shareInfo	Object	推广相关信息

productInfo 的结构

属性	类型	说明
productId	string	商品SPU ID
title	string	商品标题
subTitle	string	商品子标题
headImg	Array.<string>	商品主图
minPrice	number	商品最低价格，单位分
discount	number	商品优惠金额，单位分
discountPrice	number	商品券后最低价格，单位分
shopName	string	商店名称
pluginResult	number	是否引用小商店组件（未引用组件的商品不可推广），0：否，1：是
totalStockNum	number	商品库存

shareInfo 的结构

属性	类型	说明
appId	string	推广商品的小程序AppID
path	string	推广商品的小程序Path
couponPath	string	推广商品的带券小程序Path
wxaCode	string	已废弃。推广商品详情页的不带券葵花码图片
couponWxaCode	string	已废弃。推广商品详情页的带券葵花码图片
promotionUrl	string	推广商品短链
couponPromotionUrl	string	推广商品带券短链
promotionWording	string	推广商品文案
couponPromotionWording	string	推广商品带券文案
promotionTag	string	推广商品tag
couponPromotionTag	string	推广商品带券tag

# 返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "list": [
    {
      "pid": "oUkIc71zinc2mtlfC7K-NfGJxxNE_328751529",
      "productInfo": {
        "productId": "14495674",
        "title": "洗衣液",
        "subTitle": "",
        "headImg": [
          "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/601151160005275c000000003e9f9d09000000a000004f50"
        ],
        "minPrice": 12300,
        "shopName": "猪腩肉小商店"
      },
      "shareInfo": {
        "appId": "wxb825f130c284597f",
        "path": "plugin-private://wx34345ae5855f892d/pages/productDetail/productDetail?productId=14495788&ticket=dasdfa2V0NzIx123MTI4MDAxODadfdI4NDE3NabcMA",
        "wxaCode": "data:image/jpeg;base64,iVBORw0KGgoAAAANSUhEUgAAAa4A",
        "promotionWording": "好评💦好价速撸🔰价格实惠🐸\n————\n黄酒\n\n开抢啦：123元，比市场价优惠2311元",
        "promotionUrl": "https://mmbizurl.cn/s/017btcGpB",
        "promotionTag":"#小程序://洗衣液/94v9DtmSkiZx4Jd",
        "couponPromotionTag":"#小程序://洗衣液/86v9dddFXGGY",
      }
    }
  ]
}

# 错误码

值	说明
201000	批量获取推广素材异常
201001	批量获取推广素材超过上限