DEL Gỡ Sản phẩm khỏi Hoạt động
Gỡ Sản phẩm khỏi Hoạt động Shop Scope bắt buộc: seller.promotion.write Sử dụng API này để gỡ các sản phẩm hoặc SKU khỏi hoạt động khuyến mãi giảm giá sản phẩm hoặc flash sale hiện có. Phiên bản 202309
DEL/promotion/202309/activities/{activity_id}/products
Request
Path
| Properties | Type | Description |
|---|---|---|
| activity_id Required | string | ID hoạt động |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng cho tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| product_ids | []string | ID của các sản phẩm cần gỡ. Số lượng tối đa: 300. |
| sku_ids | []string | ID của các SKU cần gỡ. Số lượng tối đa: 300. |
| benefit_product_ids | []string | ID của các sản phẩm hưởng lợi BXGY cần gỡ. Số lượng tối đa: 100. |
| exclude_product_ids | []string | ID của các sản phẩm loại trừ BXGY cần gỡ. Số lượng tối đa: 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 | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong thông báo. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{"activity_id":"7136104329798256386","status":"ONGOING","update_time":1661765135},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
Xem các mã lỗi phổ biến
| 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. |
Nội dung này có hữu ích không? Hữu ích
Không hữu ích
PreviousNext