小程序商品推广 | 微信开放文档

# 小程序商品推广

# 获取小程序商品推广素材

# 接口说明

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

# 请求地址

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

# 请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
pid	string		是	推广位PID
getShortUrl	boolean	true	否	是否拉取短链和推广文案，默认值为拉取
getInfo	boolean	true	否	是否拉取商品信息（除了商品id），默认值为拉取
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	商品最低价格，单位分
shopName	string	小程序名称
shopStatus	number	店铺状态，0：正常，1：店铺余额不足
totalStockNum	number	商品库存

shareInfo 的结构

注：productInfo 里 shopStatus 非 0 时，没有此结构

属性	类型	说明
appId	string	推广商品的小程序AppID
username	string	推广商品的小程序原始id
path	string	推广商品的小程序Path
promotionWording	string	推广商品文案
promotionUrl	string	推广商品短链
promotionTag	string	推广商品tag
code	number	获取素材状态码，0表示正常获取素材

# 返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "list": [
        {
            "pid": "oJtf15NzExNvQ8UnT9SNOWQpyOpw_466373468",
            "productInfo": {
                "productId": "413063159",
                "shopName": "测试商品精品商城",
                "totalStockNum": 100
            },
            "shareInfo": {
                "appId": "wxd5246f9e9041f745",
                "username": "gh_760d082de91f",
                "path": "pages/detail/detail?productId=3354&open_league_ticket=bGVhZ3VldGlja2V0OjE1NjAzOTc5NzU1MDA2MjU1Mjg0NDM5OTg2",
                "promotionWording": "😨大家都在等这款，每次都巨抢手👑把它带回家！❗️售完即止💰\n————\n测试礼盒\n\n优惠价：62元\n\n下单：https://mmbizurl.cn/u/Kr1xRsVy",
                "promotionUrl": "https://mmbizurl.cn/u/Kr1xRsV",
                "promotionTag": "#小程序://测试商品精品商城/【佳琦会员专享测试商品/gRDKwkGQYkTc"
            }
        }
    ]
}

# 错误码

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