获取商品库词包
您可以使用本接口获取广告帐户下的商品库词包列表。词包是您在推广商品库时用于广告文本的一系列词汇列表。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/catalog/lexicon/get/| /v1.3/catalog/lexicon/get/|
|请求参数类型|bc_id: number<br>catalog_id: number|bc_id: string<br>catalog_id: string|
|返回参数名称|meta_field|metadata|
|返回参数类型|catalog_id: number|catalog_id: string|
|返回参数名称与类型|id: number|lexicon_id`: string|
## 请求
**地址**
https://business-api.tiktok.com/open_api/v1.3/catalog/lexicon/get/
**方法**
GET
**Header**
```xtable
|字段|类型|描述|
|--- |--- |--- |
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|--- |--- |--- |
|bc_id {必填}|string|商务中心ID。|
|catalog_id {必填}|number|商品库ID。|
示例
(code curl http)
curl -X GET -H "Access-Token:YOUR_ACCESS_TOKEN" \
--data-urlencode "bc_id=BC_ID" \
--data-urlencode "catalog_id=CATALOG_ID" \
https://business-api.tiktok.com/open_api/v1.3/catalog/lexicon/get/
(/code)
返回
|字段|类型|描述|
|--- |--- |--- |
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data|object|返回数据。|
#|list|object[]|商品库词包列表。|
##|lexicon_id|string|词包ID。|
##|catalog_id|string|商品库ID。|
##|name|string|词包名称。|
##|type|string|词包类型。|
##|metadata|string|元数据字段。|
##|default_value|string|默认词。|
##|update_time|string|更新时间。|
|request_id |string|请求的日志 ID，唯一标识一个请求。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"list": [
{
"default_value": "",
"update_time": "2020-09-16 13:31:59",
"metadata": "brand.brandName",
"name": "brand",
"catalog_id": "6873077759237687045",
"type": "META",
"lexicon_id": "11375"
},
{
"default_value": "",
"update_time": "2020-09-16 13:31:59",
"metadata": "description",
"name": "description",
"catalog_id": "6873077759237687045",
"type": "META",
"lexicon_id": "11382"
}
]
},
"request_id": "2020120309373701023125321495995"
}
(/code);