← 返回目录
📁 API Reference › Catalog Products

获取商品操作结果

您可以使用本接口了解商品上传或删除是否成功，以及上传或删除失败的后续操作建议。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/catalog/product/log/| /v1.3/catalog/product/log/| |请求参数类型|bc_id: number<br>catalog_id: number<br>feed_log_id: number|bc_id: string<br>catalog_id: string <br>feed_log_id: string| |返回参数名称|status<br>product_feeds_log<br>feeds_Log_data<br>error_effected_products<ul><li>effected_product_count</li><li>items_product_item_list</li><li>id</li><li>link</li><li>suggest</li></ul>warn_effected_products<ul><li>effected_product_count</li><li>items_product_item_list</li><li>id</li><li>link</li><li>suggest</li></ul>|process_status<br>product_feed_log<br>feed_log_data<br>error_affected_products<ul><li>affected_product_count</li><li>affected_product_item_list</li><li>sku_id</li><li>product_url</li><li>suggestion</li></ul>warn_affected_products<ul><li>affected_product_count</li><li>affected_product_item_list</li><li>sku_id</li><li>product_url</li><li>suggestion</li></ul>| |返回参数类型|catalog_id: number|catalog_id: string| |返回参数名称和类型|feeds_id: number|feed_id: string| |新增返回参数|/|<ul><li>hotel_id</li><li>name</li><li>flight_id</li><li>airline_company</li><li>media_title_id</li><li>vehicle_id</li><li>make</li><li>series_id`|


## 请求

**地址**https://business-api.tiktok.com/open_api/v1.3/catalog/product/log/

**方法** GET

**Header**

```xtable
|字段|类型|描述|
|--- |--- |--- |
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|--- |--- |--- |
|bc_id {必填}|string|商务中心 ID。|
|catalog_id {必填}|string|商品库 ID。|
|feed_log_id {必填}|string|商品处理日志 ID。|
|language|string|支持的语言。<br><br>枚举值：<ul><li> `en`：英文</li><li>`zh-CN`：中文</li><li>`ja-JP`：日文</li><li>`de`：德语</li><li>`es`：西班牙语</li><li> `fr`：法语</li><li>`hi-IN`：印地语（印度）</li><li>`id`：印尼语</li><li>`it`：意大利语</li><li>`ko`：韩语</li><li>`ms`：马来语</li><li>`ru`：俄语</li><li>`th`：泰语</li><li>`tr`：土耳其语</li><li>`vi`：越南语</li></ul><br>默认值：`en`。|

示例

(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,\"feed_log_id\": FEED_LOG_ID,\"language\": \"LANGUAGE\"}' \
    https://business-api.tiktok.com/open_api/v1.3/catalog/product/log/

(/code)

返回

|字段{35%}|类型{15%}|描述{50%}|
|--- |--- |--- |
|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_feed_log|object|商品处理结果。|
##|catalog_id|string|商品库ID。|
##|feed_id|string|更新源ID。|
##|add_count|number|新增的商品总数。|
##|update_count|number|修改的商品总数。|
##|delete_count|number|删除的商品总数。|
##|error_count|number|上传失败的商品数量。|
##|warn_count|number|被警告的商品数量。|
##|process_status|string|处理状态。<br><br>枚举值： <ul><li>`WAITING`：等待中，有其他任务待处理完成。</li><li>`PROCESSING`：处理中。</li><li>`SUCCESS`：处理成功。</li><li> `FAILED`：处理失败。</li></ul>|
##|update_mode|number|更新模式。<br><br>枚举值：<ul><li>`INCREASE`：增量。</li><li>`REPLACE`：全量。</li></ul>|
##|start_time|string|开始时间。|
##|end_time|string|结束时间。|
##|feed_log_data|object|详细处理信息。|
###|download_path|object|文件下载地址，包含所有错误/警告信息，key是语言，value是文件地址。|
###|error_affected_products|object[]|错误信息。|
####|affected_product_count|number|受影响商品数。|
####|affected_product_item_list|object[]|受影响商品列表，只展示前五条。|
#####|index|number|商品索引，代表该商品在所上传商品列表中的位置。<br>例如，索引值为 2 代表该商品为通过[/catalog/product/file/](1740496787164161.html)或[/catalog/product/upload/](1740497429681153.html)上传的商品列表中的第 1 个商品。|
#####|title|string|仅为电商商品库、娱乐商品库、汽车库存商品库、汽车型号商品库或短剧商品库中的商品返回此字段。<br><br>电商商品库、娱乐商品库、汽车库存商品库或汽车型号商品库中商品的标题或短剧商品库中短剧的名称。|
#####|sku_id|string|仅为电商商品库中的商品返回此字段。<br><br>商品的唯一 ID，例如 SKU。|
#####|hotel_id|string|仅为酒店商品库中的商品返回此字段。<br><br>酒店的唯一ID。|
#####| name|string|仅为酒店商品库或目的地商品库中的商品返回此字段。<br><br>酒店或目的地的名称。|
#####|flight_id|string|仅为航班商品库中的商品返回此字段。<br><br>航班的唯一ID。|
#####|airline_company|string|仅为航班商品库中的商品返回此字段。<br><br>运营该航班的航空公司的名称。|
#####|media_title_id|string|仅为娱乐商品库中的商品返回此字段。<br><br>媒体标题项的唯一ID。|
#####| vehicle_id | string | 仅为汽车库存商品库或汽车型号商品库中的车辆返回此字段。<br><br>车辆的唯一ID。 |
#####| make | string | 仅为汽车库存商品库或汽车型号商品库中的车辆返回此字段。<br><br>车辆的品牌。 |
#####|series_id|string|仅为短剧商品库中的商品返回此字段。<br><br>短剧的自定义唯一 ID。|
#####|product_url|string|商品链接。|
#####|description|string|商品描述。|
#####|value|string|字段值。|
####|field|string|问题字段。|
####|issue|string|问题信息。|
####|suggestion|string|解决建议。|
###|warn_affected_products|object[]|警告信息。|
####|affected_product_count|number|受影响商品数。|
####|affected_product_item_list|object[]|受影响商品列表，只展示前五条。|
#####|index|number|商品索引，代表该商品在所上传商品列表中的位置。<br>例如，索引值为 2 代表该商品为通过[/catalog/product/file/](1740496787164161.html)或[/catalog/product/upload/](1740497429681153.html)上传的商品列表中的第 1 个商品。|
#####|title|string|仅为电商商品库、娱乐商品库、汽车库存商品库、汽车型号商品库或短剧商品库中的商品返回此字段。<br><br>电商商品库、娱乐商品库、汽车库存商品库或汽车型号商品库中商品的标题或短剧商品库中短剧的名称。|
#####|sku_id|string|仅为电商商品库中的商品返回此字段。<br><br>商品的唯一 ID，例如 SKU。|
#####|hotel_id|string|仅为酒店商品库中的商品返回此字段。<br><br>酒店的唯一ID。|
#####| name|string|仅为酒店商品库或目的地商品库中的商品返回此字段。<br><br>酒店或目的地的名称。|
#####|flight_id|string|仅为航班商品库中的商品返回此字段。<br><br>航班的唯一ID。|
#####|airline_company|string|仅为航班商品库中的商品返回此字段。<br><br>运营该航班的航空公司的名称。|
#####|media_title_id|string|仅为娱乐商品库中的商品返回此字段。<br><br>媒体标题项的唯一ID。|
#####| vehicle_id | string | 仅为汽车库存商品库或汽车型号商品库中的车辆返回此字段。<br><br>车辆的唯一ID。 |
#####| make | string | 仅为汽车库存商品库或汽车型号商品库中的车辆返回此字段。<br><br>车辆的品牌。 |
#####|series_id|string|仅为短剧商品库中的商品返回此字段。<br><br>短剧的自定义唯一 ID。|
#####|product_url|string|商品链接。|
#####|description|string|商品描述。|
#####|value|string|字段值。|
####|field|string|问题字段。|
####|issue|string|问题信息。|
####|suggestion|string|解决建议。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
    "product_feed_log": {
        "process_status": "SUCCESS",
        "update_mode": "INCREASE",
        "error_count": 0,
        "add_count": 0,
        "feeds_id": 2335,
        "warn_count": 1,
        "delete_count": 0,
        "feed_log_data": {
            "error_affected_products": null,
            "warn_affected_products": [
                {
                    "suggestion": "The \"age_group\" field is using an invalid value. Supported values only include: newborn/infant/toddler/kids/adult",
                    "issue": "Invalid value: age_group",
                    "field": "age_group",
                    "affected_product_count": 1,
                    "affected_product_item_list": [
                        {
                            "index": 3,
                            "sku_id": "tiktok_item_12424",
                            "description": "qgs test product description",
                            "title": "qgs test product",
                            "value": "None",
                            "product_url": "https://ads.tiktok.com"
                        }
                    ]
                },
                {
                    "suggestion": "The \"gender\" field is using an invalid value. Supported values only include: male/female/unisex",
                    "issue": "Invalid value: gender",
                    "field": "gender",
                    "affected_product_count": 1,
                    "affected_product_item_list": [
                        {
                            "index": 3,
                            "sku_id": "tiktok_item_12424",
                            "description": "qgs test product description",
                            "title": "qgs test product",
                            "value": "None",
                            "product_url": "https://ads.tiktok.com"
                        }
                    ]
                }
            ],
            "download_path": {
                "ru": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_ru.csv",
                "fr": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_fr.csv",
                "en": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_en.csv",
                "ms": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_ms.csv",
                "ko": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_ko.csv",
                "vi": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_vi.csv",
                "de": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_de.csv",
                "tr": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_tr.csv",
                "it": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_it.csv",
                "zh-CN": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_zh-CN.csv",
                "hi-IN": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_hi-IN.csv",
                "th": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_th.csv",
                "ja-JP": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_ja-JP.csv",
                "id": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_id.csv",
                "es": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_es.csv"
            }
        },
        "catalog_id": 6865965734837634822,
        "update_count": 2,
        "start_time": "2020-09-14 05:15:09",
        "end_time": "2020-09-14 05:15:09"
    }
},
"request_id": "2020091406394701023125321410044"
}
(/code);
← 通过 JSON 结构上传商品获取商品信息 →

内容来源：TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了？
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →