获取商品信息
您可以使用本接口获取指定商品系列下的商品信息。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/catalog/set/info/| /v1.3/catalog/set/product/get/|
|请求参数类型|bc_id: number<br>catalog_id: number|bc_id: string<br>catalog_id: string|
|请求参数名称和类型|set_id: number|product_set_id: string|
|返回参数名称|count<br>list|product_count<br>products|
|返回参数类型|catalog_id: number<br>product_id: number|catalog_id: string<br>product_id: string|
|返回参数名称和类型|id: number|product_set_id: string|
|新增返回参数|/|hotel_id<br>flight_id<br>destination_id<br>vehicle_id`|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/catalog/set/product/get/
**方法** GET
**Header**
```xtable
|字段|类型|描述|
|--- |--- |--- |
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|
参数
|字段|类型|描述|
|--- |--- |--- |
|bc_id {必填}|string|商务中心ID。|
|catalog_id {必填}|string|商品库ID。|
|product_set_id {必填}|string|商品系列ID。|
|page|number|当前页数。默认值：1。|
|page_size|number|分页大小。默认值：20。|
示例
(code curl http)
curl -X GET -H "Access-Token:YOUR_ACCESS_TOKEN" \
-H "Content-Type:application/json" \
-d '{\"bc_id\": BC_ID,\"catalog_id\": CATALOG_ID,\"product_set_id\": SET_ID},\"page\": PAGE,\"page_size\": PAGE_SIZE' \
https://business-api.tiktok.com/open_api/v1.3/catalog/set/info/
(/code)
返回
|字段|类型|描述|
|--- |--- |--- |
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string|请求日志 ID。|
|data|object|返回数据。|
#|product_set_id|string|商品系列 ID。|
#|catalog_id|string|商品库 ID。|
#|product_count|number|该商品系列下的商品数。|
#|products|object[]|商品列表。|
##|product_id|number|商品 ID。|
##|product_name|string|商品名称。|
##|sku_id|string|仅为电商商品库中的商品返回本字段。<br><br>电商商品的唯一 ID。|
##| hotel_id | string | 仅为酒店商品库中的酒店返回本字段。 <br><br> 酒店的唯一 ID。 |
##| flight_id | string | 仅为航班商品库中的航班返回本字段。<br><br> 航班的唯一 ID。 |
##| destination_id | string | 仅为目的地商品库中的目的地返回本字段。 <br><br>目的地的唯一 ID。 |
##|vehicle_id|string|仅为汽车库存商品库或汽车型号商品库中的车辆返回返回本字段。<br><br>车辆的唯一 ID。|
#|page_info|object|分页信息。|
##|page|number|当前页数。|
##|page_size|number|分页大小。|
##|total_number|number|总结果数。|
##|total_page|number|总页数。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"product_count": 2,
"page_info": {
"total_number": 2,
"page": 1,
"page_size": 20,
"total_page": 1
},
"products": [
{
"sku_id": "test_2",
"product_id": 6933990518728918789,
"product_name": "pro_2"
},
{
"sku_id": "test_1",
"product_id": 6933990518728935173,
"product_name": "pro_1"
}
],
"catalog_id": 6873077759237687045,
"product_set_id": 1547
},
"request_id": "20210301065500010231016022235FAE"
}
(/code);