快工助手跨境电商知识与商机助手

(42) Combined listing change

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 1. Trigger scenario

This webhook is triggered when a combined listing is created, updated (the list of products in the combined listing changes), or deleted. Prerequisite: The "Product Basic" API scope is enabled in Partner Center. For more information, refer to Access Scope.

#

§2 2. Data business parameters

Parameter nameData typeSampleDescription
typeint42The ID of this webhook topic, which is 42.
tts_notification_idstring"7327112393057371910"The ID of this webhook notification.
shop_idstring"7494049642642441621"The shop ID.
timestampint1644412885The time when this webhook is triggered. Unix timestamp.
dataobject
└ combined_listing_idstring"123456789"The combined listing ID.
└ products[]objectThe current list of products in this combined listing after the change.
└└ idstring"987654321"The product id.
└ statusstring"LIVE"The status of the combined listing. Possible values: * LIVE * SYSTEM_DEACTIVATED * SELLER_DEACTIVATED * DELETED Note: Only products in LIVE combined listings will appear on the product display page.
└ change_typestring"UPDATE"The type of change made to this combined listing. Possible values: * CREATE: The combined listing was created. * UPDATE: The combined listing was updated to add or remove products. * DELETE: The combined listing was deleted.
└ added_product_ids[]string["987654321"]The list of products that were newly added to the combined listing.
└ removed_product_ids[]string["987654322"]The list of products that were removed from the combined listing.
#

§3 Event example

Event example

{
  "type": 42,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": {
    "combined_listing_id": "123456789",
    "products": [
      {
        "id": "987654321"
      },
      {
        "id": "987654322"
      }
    ],
    "status": "LIVE",
    "change_type": "UPDATE",
    "added_product_ids": ["987654321"],
    "removed_product_ids": ["987654333"]    
  }
}
#