stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Get Opportunity Detail and List Opportunity APIs: New Fields Added
#§2 Summary
Summary
Get Opportunity Detail and List Opportunity APIs add new response fields to provide opportunity tag codes and reference product information. Get Opportunity Detail also adds opportunity tags, while List Opportunity adds information about rewards sellers can receive for listing products as required.
List Opportunity also supports filtering opportunities by tag codes through a new optional request field, tag_codes.
§3 What is changing
What is changing
Get Opportunity Detail — 4 new response fields
| Field | Type | Description |
|---|---|---|
tags | String | Tags associated with the opportunity. |
tag_codes | List<String> | Tag codes mapped one-to-one, in order, to tags. Supported values for LATAM include CORE_PRODUCT and TOP_PRODUCT. |
external_product_id | String | Product ID on the reference source. -Only for LATAM |
reference_source | String | Reference source code. Returned only when external_product_id is present. -Only for LATAM |
List Opportunity — 1 new request field
| Field | Type | Required | Description |
|---|---|---|---|
tag_codes | List<String> | No | Filters opportunities by tag codes. Example: ["CORE_PRODUCT", "TOP_PRODUCT"]. |
List Opportunity — 4 new response fields under data.opportunities[]
| Field | Type | Description |
|---|---|---|
tag_codes | List<String> | Tag codes mapped one-to-one, in order, to tags. Supported values for LATAM include CORE_PRODUCT and TOP_PRODUCT. |
reward_info | String | Rewards sellers can receive for listing products as required. |
external_product_id | String | Product ID on the reference source. -Only for LATAM |
reference_source | String | Reference source code. Returned only when external_product_id is present. -Only for LATAM |
§4 What action is required
What action is required
If your app uses Get Opportunity Detail or List Opportunity, review the following updates. Recommended actions:
- Update your response models to support the new fields. Note that
tagsis a string, whiletag_codesis an array of strings. - Include the optional
tag_codesrequest field in List Opportunity when filtering opportunities by tag. - Use
reward_infoto display available listing rewards, andexternal_product_idtogether withreference_sourceto identify reference products. - Handle responses where
reference_sourceis absent. - Test the updated request and response handling before deploying your integration changes.
变化记录
相对上一发布版本，本文内容有变化。
本版没有改过这篇（或它是新增页），没有可比的上一版。