DEL Remove Activity Product
Remove Activity Product Shop Required scope: seller.promotion.write Use this API to remove products or SKUs from the existing product discount or flash sale promotion activity. Version 202309
DEL/promotion/202309/activities/{activity_id}/products
Request
Path
| Properties | Type | Description |
|---|---|---|
| activity_id Required | string | Activity ID |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| product_ids | []string | IDs of the products to remove.Max count: 300. |
| sku_ids | []string | IDs of the SKUs to remove.Max count: 300. |
| benefit_product_ids | []string | IDs of the BXGY benefit products to remove.Max count: 100. |
| exclude_product_ids | []string | IDs of the BXGY exclude products to remove.Max count: 100. |
Example
CurlGoNode.jsJavaEnable word wrap
123456789101112131415161718curl-X DELETE 'https://open-api.tiktokglobalshop.com/promotion/202309/activities/7402881377634567979/products?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "product_ids": [ "7493989962827597361" ], "sku_ids": [ "7135657830438176513" ], "benefit_product_ids": [ "7493989962827597361" ], "exclude_product_ids": [ "7493989962827597361" ]}'
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
{"code":0,"data":{"activity_id":"7136104329798256386","status":"ONGOING","update_time":1661765135},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
View common error codes
| Code | Message | | --- | --- | | 17027802 | Internal error, promotion purchase limit deletion failed, please try again | | 17029001 | Invalid parameters | | 17029009 | Activity does not exist | | 17029010 | Activity is deactivated | | 17029011 | Not allowed to update the beginning time of activity | | 17029012 | Not allowed to update expired activities | | 17029016 | Invalid SKU ID. | | 17029023 | Products Not In Promotion | | 17029024 | SKU(s) not found in this promotion. | | 17029028 | You are specifying activities not in your shop. | | 17029036 | ActivityType is not supported. | | 17029046 | Number of items per request exceeds the limit. | | 17029047 | An ONGOING flash sale product cannot be updated. | | 17029048 | An ONGOING flash sale SKU cannot be updated. | | 17029052 | ProductType is not supported | | 17029055 | Request Timeout | | 17029069 | Access denied. This activity does not belong to this shop and therefore cannot be modified. | | 17029074 | Eligible products and the gift products must not be the same product. | | 17029079 | Product is already assigned in another conflicting promotion. | | 17029102 | Product level and shop level are not interchangeable | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Is this content helpful?Helpful
Not Helpful
PreviousNext