stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Summary
The Promotion Activity APIs add one optional field, auction_support_type, which declares whether a promotion activity applies to auction products in addition to normal products. It is accepted as an optional request field on Create / Update Promotion Activity and returned on Get Activity / Search Promotion Activities.
§2 Impact
Impact
| Item | Detail |
|---|---|
| Impacted endpoints | Request (new optional field): Create Promotion Activity (POST /promotion/202309/activities), Update Promotion Activity (PUT /promotion/202309/activities/{activity_id}) Response (new field): Get Activity (GET /promotion/202309/activities/{activity_id}), Search Promotion Activities (POST /promotion/202309/activities/search) |
| Impacted version(s) | 202309 |
| Impacted market(s) | All markets |
| Seller type(s) / App type(s) | All seller types — both local-to-local and cross-border sellers |
| Permission scope | No new permission scope. Existing Promotion scopes are reused, and already-authorized apps do not need to be re-authorized |
| Effective date | Already live — the field is available now, no migration window |
| Compatibility | Non-breaking. Only one optional request field and one response field are added; no field, enum value or behavior is removed or changed |
§3 Field-level diff
Field-level diff
| API | Field | Old | New |
|---|---|---|---|
| Create Promotion Activity | auction_support_type | Not available | string, optional (Require = N), default ALL, enum ALL / EXCLUDE_AUCTION |
| Update Promotion Activity | auction_support_type | Not available | string, optional (Require = N), default ALL, enum ALL / EXCLUDE_AUCTION |
| Get Activity | auction_support_type | Not returned | string, returned with the activity detail, value ALL / EXCLUDE_AUCTION |
| Search Promotion Activities | auction_support_type | Not returned | string, returned per activity in the list, value ALL / EXCLUDE_AUCTION |
§4 Field definition
Field definition
auction_support_type (string, optional, default ALL) determines whether the activity supports auction products.
ALL: the activity supports both normal products and auction products.EXCLUDE_AUCTION: the activity does not support auction products.
§5 Samples
Samples
{
"title": "DiscountEvent0829",
"activity_type": "FIXED_PRICE",
"product_level": "PRODUCT",
"auction_support_type": "ALL"
}
{
"code": 0,
"data": {
"activity_id": "7136104329798256386",
"activity_type": "FIXED_PRICE",
"auction_support_type": "ALL"
},
"message": "Success"
}
§6 Is this a breaking change?
Is this a breaking change?
No — this is a non-breaking, additive change.
- The new request field is optional. Existing request payloads remain valid, and omitting it keeps the current behavior (
ALL). - The new response field is additive. No existing field is removed, renamed or re-typed.
- No new permission scope is introduced, so no re-authorization is required.
§7 Developer action items
Developer action items
- If you do not manage auction products: no action is required. Existing calls keep working with the default
ALL. - If you need to exclude auction products from an activity: pass
auction_support_type = EXCLUDE_AUCTIONon Create Promotion Activity, or update an existing activity through Update Promotion Activity. - If your app has a strict response schema: add
auction_support_typeto your activity models for Get Activity and Search Promotion Activities, treat the field as optional, and tolerate unknown future enum values instead of failing the parse. - Surface the value in any UI that displays activity eligibility, so sellers can tell whether an activity covers auction products.