POST Publish Global Product
Đăng Global Product Seller Scope yêu cầu: seller.global_product.write Đăng và chuyển đổi một global product thành các local product trong một hoặc nhiều shop tại các thị trường được hỗ trợ. Sau khi đăng, sản phẩm được gửi để TikTok Shop xét duyệt tại các thị trường tương ứng. Đối với người bán tại thị trường EU, thông tin được cung cấp cũng sẽ được tự động dịch sang tất cả các ngôn ngữ EU mà TikTok Shop hỗ trợ. Lưu ý:
- Bạn chỉ có thể đăng tại mỗi thị trường một lần. Để thay đổi thông tin sản phẩm, hãy chỉnh sửa global product bằng cách dùng Edit Global Product API
. Các thay đổi sẽ được tự động đồng bộ tới tất cả các thị trường nơi sản phẩm được đăng
- Dùng Get Product API
để lấy thông tin local product đã chuyển đổi theo ngôn ngữ của thị trường mục tiêu.
- Dùng Edit Product API
hoặc Partial Edit Product API
để chỉnh sửa thông tin local product, nếu cần. Version 202309
POST/product/202309/global_products/{global_product_id}/publish
Request
Path
| Properties | Type | Description |
|---|---|---|
| global_product_id Required | string | Id của global product. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán lấy 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 riêng. Vui lòng dùng key cụ thể được cấp 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 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 dùng cho tất cả các yêu cầu API. Nhà phát triển có thể dùng nó để chuyển đổi sang giờ địa phương. |
Body
| Properties | Type | Description |
|---|---|---|
| publish_target Required | []object | Các thị trường mục tiêu để đăng global product. |
Example
CurlGoNode.jsJavaEnable word wrap
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 của yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 12019004 | Seller is inactive | | 12019010 | product price is invalid | | 12019016 | Unable to publish or sync products to target markets due to missing or invalid warehouse details. | | 12019028 | Multiple warehouses detected. Include all warehouse IDs and the corresponding details and try again. | | 12019113 | product status is invalid | | 12019121 | calculate price error | | 12019150 | The product ID does not exist. | | 12019212 | region already published | | 12052055 | The SKU inventory quantity for the warehouse must be within allowed limits. | | 12052084 | The provided currency is not available for this shop/region. | | 12052117 | seller publish global product over limit and save draft | | 12052145 | activity warehouse not allowed to be deleted | | 12052146 | The specified inventory quantity is too low. It must be greater than the locked quantity (e.g. for committed orders, campaigns, creators) to ensure a non-negative available stock. | | 12052260 | The product ID does not exist | | 12052379 | the cover region of share warehouse can not cover the the product region | | 12052424 | Missing 'sale price' value | | 12052531 | The warehouse is disabled. | | 12052556 | The SKU id not exist. | | 12052700 | The seller is inactive. | | 12052701 | do not support cross-boarder seller create local product directly | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12052901 | The product in its current status is not available for this operation. Change the product status and try again. | | 12052903 | The publish region is inactive. | | 12052910 | Invalid input parameters. Refer to the API documentation for details. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext