返傭商品
導(dǎo)入商品
每次調(diào)用支持批量導(dǎo)入不超過 1000 條的商品信息。每分鐘單個(gè)商戶全局調(diào)用次數(shù)不得超過 200 次。每天調(diào)用次數(shù)不得超過 100 萬次。每次請(qǐng)求包大小不超過 2M。
<?php
$data = [
[
'pid' => 'pid001',
'image_info' => [
'main_image_list' => [
[
'url' => 'http://www.google.com/a.jpg',
],
[
'url' => 'http://www.google.com/b.jpg',
],
],
],
// ...
],
// ...
];
$result = $officialAccount->goods->add($data);
/* $result:
{
"errcode": 0,
"errmsg": "ok",
"status_ticket": "115141102647330200"
}
*/
status_ticket 用于獲取此次導(dǎo)入的詳細(xì)結(jié)果。
更新商品
更新時(shí),字段不填代表不更新該字段(此處的字段不填,代表無此字段,而不是把字段的值設(shè)為空,設(shè)為空即代表更新該字段為空)。
對(duì)于字符串類型的選填字段,如副標(biāo)題,若清空不展示,則可設(shè)置為空;對(duì)于數(shù)字類型的選填字段,如原價(jià),若清空不展示,則需設(shè)置為 0。
基本字段更新中
pid為必填字段,且無法修改。
<?php
$data = [
[
'pid' => 'pid001',
'image_info' => [
'main_image_list' => [
[
'url' => 'http://www.baidu.com/c.jpg',
],
[
'url' => 'http://www.baidu.com/d.jpg',
],
],
],
// ...
],
// ...
];
$result = $officialAccount->goods->update($data);
/* $result:
{
"errcode": 0,
"errmsg": "ok",
"status_ticket": "115141102647330200"
}
*/
說明:導(dǎo)入商品和更新商品使用的是同一個(gè)接口。
查詢導(dǎo)入/更新商品狀態(tài)
用于查詢導(dǎo)入或更新商品的結(jié)果,當(dāng)導(dǎo)入或更新商品失敗時(shí),若為系統(tǒng)錯(cuò)誤可進(jìn)行重試;若為其他錯(cuò)誤,請(qǐng)排查解決后進(jìn)行重試。
<?php
$status_ticket = '115141102647330200';
$result = $officialAccount->goods->status($status_ticket);
/* $result:
{
"errcode": 0,
"errmsg": "ok",
"result": {
"succ_cnt": 2,
"fail_cnt": 0,
"total_cnt": 2,
"progress": "100.00%",
"statuses": [
{
"pid": "pid001",
"ret": 0,
"err_msg": "success",
"err_msg_zh_cn": "成功"
},
{
"pid": "pid002",
"ret": 0,
"err_msg": "success",
"err_msg_zh_cn": "成功"
}
]
}
}
*/
獲取單個(gè)商品信息
使用該接口獲取已導(dǎo)入的商品信息,供驗(yàn)證信息及抽查導(dǎo)入情況使用。
<?php
$pid = 'pid001';
$officialAccount->goods->get($pid);
返回結(jié)果中的
product字段內(nèi)容與導(dǎo)入商品接口字段一致,導(dǎo)入時(shí)未設(shè)置的值有可能獲取時(shí)仍會(huì)返回,但顯示為空。
分頁獲取商品信息
使用該接口可獲取已導(dǎo)入的全量商品信息,供全量驗(yàn)證信息使用。
<?php
// $page 為 1 時(shí)傳空即可。當(dāng) $page 大于 1 時(shí)必填,填入上一次訪問本接口返回的 page_context。
$context = '';
$page = 1; // 頁碼
$size = 10; // 每頁數(shù)據(jù)大小,目前限制為 100 以內(nèi),注意一次全量驗(yàn)證過程中該參數(shù)的值需保持不變
$officialAccount->goods->list($context, $page, $size);
返回結(jié)果中的
product字段內(nèi)容與導(dǎo)入商品接口字段一致,導(dǎo)入時(shí)未設(shè)置的值有可能獲取時(shí)仍會(huì)返回,但顯示為空。page_context字段用于獲取下一頁數(shù)據(jù)時(shí)使用。