跳到主要内容

广告商品信息更新


前置条件

完成商品添加


请求地址​

https://api.e.qq.com/v1.3/product_items/update


所属权限​

广告管理（Ads Management）


请求方法​

POST


请求参数​

参数名描述
access_token授权令牌，完成 OAuth 2.0 授权后获得，参考开发者环境
timestamp当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型​

application/json


请求体参数​

阅读说明：Y - 必填；C - 条件选填（conditional），请关注“描述”信息；空 - 非必填

名称类型必填描述
account_idintegerY
推广帐号 id或 DataNexus 账号 id
catalog_idintegerY
商品库 id
product_outer_idstringY
商品 id，字段长度最小 1 字节，长度最大 255 字节
pricefloat
商品价格，商品价格（单位：元），大于等于 0，至多 2 位小数，最小值 0，最大值 9223372036854775807
sale_pricefloat
商品促销价格（单位：元），大于等于 0，至多 2 位小数，最小值 0，最大值 9223372036854775807
price_pcfloat
商品PC上价格（单位：元），大于等于 0，至多 2 位小数，最小值 0，最大值 9223372036854775807
price_mobilefloat
商品移动上价格（单位：元），大于等于 0，至多 2 位小数，最小值 0，最大值 9223372036854775807
price_appfloat
商品APP上价格（单位：元），大于等于 0，至多 2 位小数，最小值 0，最大值 9223372036854775807
stock_volumeinteger
库存量，大于等于 0
discountfloat
折扣，大于等于 0，小于等于 1，至多 2 位小数
expiration_timeinteger
商品下架时间，unix timestamp，大于等于 0
product_sale_statusenum
商品销售状态，枚举列表：{ PRODUCT_SALE_STATUS_ONLINE, PRODUCT_SALE_STATUS_OFFLINE }

请求示例​

curl 'https://api.e.qq.com/v1.3/product_items/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
    "account_id": 111111111,
    "catalog_id": 1234,
    "product_outer_id": "xly_123",
    "price": 12.9900000000000002131628207280300557613372802734375,
    "sale_price": 12.9900000000000002131628207280300557613372802734375,
    "price_pc": 12.9900000000000002131628207280300557613372802734375,
    "price_mobile": 12.9900000000000002131628207280300557613372802734375,
    "price_app": 11.8800000000000007815970093361102044582366943359375,
    "stock_volume": 1000,
    "discount": 0.84999999999999997779553950749686919152736663818359375,
    "expiration_time": 1516774131
}'

应答体结构​

无


应答示例​

{
    "code": 0,
    "message": "",
    "message_cn": ""
}



该内容是否有帮助？