PUT Edit Global Product
Chỉnh sửa Global Product Seller Required scope: seller.global_product.write Chỉnh sửa tất cả thuộc tính (ví dụ: mô tả, thương hiệu, hình ảnh, attributes) của một global product. QUAN TRỌNG: Đối với các sản phẩm đã được đăng (published), các thay đổi sẽ tự động được dịch lại và đồng bộ đến tất cả thị trường nơi sản phẩm được đăng. Nếu bạn đã chỉnh sửa thông tin sản phẩm hoặc bản dịch của các local product liên kết, chúng sẽ bị ghi đè bởi thông tin trong API này. Ví dụ, nếu bạn đã tùy chỉnh giá địa phương như giá trước thuế địa phương hoặc giá hiển thị địa phương, chúng sẽ bị ghi đè mỗi khi API này được gọi. Lưu ý:
- Có thể có giới hạn số lượng sản phẩm bạn có thể đăng lại mỗi ngày. Chúng tôi khuyên bạn nên ưu tiên các sản phẩm chính trước để đảm bảo chúng được đăng. Bạn có thể tìm thấy giới hạn đăng sản phẩm của mình trên trang chủ Seller Center.
- Tất cả các giá trị nhập vào, bao gồm cả khoảng trống, trong request payload sẽ ghi đè các giá trị hiện có. Để giữ lại một giá trị hiện có, hãy đảm bảo bao gồm nó trong yêu cầu của bạn. Do đó, chúng tôi đặc biệt khuyến nghị truy xuất dữ liệu sản phẩm mới nhất bằng Get Global Product
và gửi đầy đủ dữ liệu khi chỉnh sửa. Điều này đảm bảo độ chính xác và giúp tránh lỗi hoặc mất dữ liệu ngoài ý muốn do thiếu trường.
- Ngôn ngữ được sử dụng trong nội dung sản phẩm phải phù hợp với ngôn ngữ của thị trường mục tiêu (ví dụ: không sử dụng tiếng Trung), nếu không việc đăng sản phẩm sẽ thất bại hoặc bị từ chối. Version 202309
PUT/product/202309/global_products/{global_product_id}
Request
Path
| Properties | Type | Description |
|---|---|---|
| global_product_id Required | string | Global product ID được tạo bởi TikTok Shop. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
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 trên tất cả các yêu cầu API. Nhà phát triển có thể sử dụng để chuyển đổi sang giờ địa phương. |
Body
| Properties | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| title Required | string | Tiêu đề sản phẩm. Độ dài tiêu đề:- DE, ES, FR, IE, IT, JP, UK, US: [1, 255] - MX:[1,300] - Các khu vực khác: [25, 255] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| description Required | string | Mô tả sản phẩm ở định dạng HTML.Lưu ý:- Nội dung phải tuân theo cú pháp HTML. Tất cả các thẻ HTML đều được chấp nhận nhưng để tối ưu hiển thị trên trang chi tiết sản phẩm TikTok Shop, hệ thống sẽ tự động chuyển đổi một số thẻ nhất định sang định dạng thay thế, chẳng hạn như render các thẻ thành hình ảnh.- Độ dài tối đa: 10,000 ký tự.- Hướng dẫn về hình ảnh: Bạn phải sử dụng TikTok Shop image URLs. Tối đa 30 thẻ
Example CurlGoNode.jsJavaEnable word wrap Response Parameters
Example JSONEnable word wrap Error Code View common error codes | Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12019010 | product price is invalid | | 12019011 | product package weight is invalid | | 12019013 | brand id is invalid | | 12019016 | Unable to publish or sync products to target markets due to missing or invalid warehouse details. | | 12019064 | No matching categories. Provide the full name of your product, edit its product properties, and try again. | | 12019113 | product status is invalid | | 12019114 | Seller has no permission | | 12019117 | Missing variations (sales attributes). When there are multiple SKUs in a product, each SKU must include variation (sales attribute) details that explain how it is different from other SKUs in the product. | | 12019121 | calculate price error | | 12019150 | The product ID does not exist. | | 12052012 | Incorrect price format | | 12052013 | The product description cannot exceed maximum characters | | 12052015 | The product description is required | | 12052016 | The parcel weight is required | | 12052023 | Category does not exist | | 12052024 | Category is not final category | | 12052026 | Brand does not exist | | 12052028 | Main product image is required | | 12052048 | You cannot edit the specified product(s) as it isn't listed in your account or shop. | | 12052050 | A single product cannot have more than 100 different SKUs | | 12052051 | The product name exceed max limit characters | | 12052054 | The seller SKU text length cannot exceed max limit characters | | 12052055 | The SKU inventory quantity for the warehouse must be within allowed limits. | | 12052056 | The num of image in description cannot exceed max limit | | 12052073 | The product price is invalid | | 12052084 | The provided currency is not available for this shop/region. | | 12052096 | Unable to update the price for SKUs with no warehouse. Assign a warehouse and try again. | | 12052104 | property is required | | 12052105 | required qualification miss | | 12052116 | product package size is invalid | | 12052142 | no permission of multi global warehouse | | 12052143 | sku warehouse must equal | | 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. | | 12052200 | brand is expired | | 12052201 | You are not authorized to sell this brand in this category. To do so, apply through the Qualification Center in Seller Center. | | 12052208 | A brand authorization is required to publish this listing. | | 12052217 | All region shops must use V2 categories. Check the documentation for further details. | | 12052220 | This category is prohibited or unsupported on TikTok Shop. Select another category. | | 12052221 | Only whitelisted sellers are permitted to trade under current category | | 12052222 | category do not support cod | | 12052225 | You are not authorized to sell in this category because it does not fall under your shop's main category. Contact your account manager for help or select another category. | | 12052226 | This category is restricted. To sell in this category, apply through the Qualification Center in Seller Center. | | 12052227 | the category is unauthorized or unavailable | | 12052230 | Category version and categoryID are not matched. | | 12052240 | Do not support custom property. | | 12052241 | attribute name or attribute id is empty. | | 12052242 | The attribute name characters cannot exceed max_limit | | 12052243 | The product attribute or sale attribute name characters contain Chinese. | | 12052244 | The attribute name duplicate. | | 12052245 | The product attributes contained invalid characters. Please modify and re-submit. | | 12052246 | The {{property_type}} not support multi selected, attribute id is :{{property_id}}. | | 12052247 | Do not support custom product attribute. | | 12052248 | The {{property_type}} value name or attribute value id is empty. | | 12052249 | The {{property_type}} value name characters cannot exceed {{max_limit}}, attribute value name is :{{property_value_name}}. | | 12052250 | The {{property_type}} value name characters contain Chinese. | | 12052251 | Duplicated attribute values found for an attribute. Remove or modify the duplicated value. | | 12052254 | Duplicate attribute id | | 12052260 | The product ID does not exist | | 12052261 | product name is empty | | 12052262 | Chinese characters are not supported in product name | | 12052266 | The product name contains non-English characters. | | 12052282 | Product manufacturer is required. | | 12052285 | Manufacturer ID {{manufacturer_id}} is not associated with the seller | | 12052287 | Product responsible person is required | | 12052288 | The number of responsible person ids cannot exceed {{max_limit}}, and cannot less {{min_limit}}. | | 12052290 | Responsible person ID {{rp_id}} is not associated with the seller | | 12052296 | Duplicate responsible person IDs associated with the same product | | 12052300 | product main image uri illegal | | 12052301 | Width and length of main image must be at least {{min_limit}}, check uri {{uri}} | | 12052302 | The main images size exceed limit. | | 12052303 | The algo prediction for category v2 of this product failed | | 12052304 | Main product image format not support. | | 12052305 | The main images aspect ratio cannot exceed max limit. | | 12052306 | main product images count exceed limit | | 12052324 | Product description image file format is not supported | | 12052340 | product description image uri illegal | | 12052341 | The description images size cannot exceed limit. | | 12052342 | The description images space cannot exceed limit. | | 12052343 | Product description image format not support. | | 12052344 | The product description html syntax with error | | 12052345 | The product description html tag not support. | | 12052346 | The product description has Chinese characters | | 12052348 | The product description html tag required attribute is miss. | | 12052349 | The product description html tag not support nest. | | 12052350 | The product description html tag contain illegal attribute. | | 12052351 | The product description contains non-English characters. | | 12052360 | The video id is not exist. | | 12052379 | the cover region of share warehouse can not cover the the product region | | 12052401 | package weight exceed limit. | | 12052447 | You still have stock reserved for campaigns in your Chinese warehouse(s), so you cannot add an overseas warehouse yet. If you have an overseas warehouse, you must use it to fulfill orders for your {{country}} shop. | | 12052448 | Local fulfillment is required for {{country}} shop. You must have at least one {{country}} overseas warehouse for it. | | 12052520 | product sale property image uri illegal | | 12052521 | The sale property images size over limit. | | 12052522 | Product sale property image is required | | 12052523 | Product sale property image format not support. | | 12052524 | The sale property image aspect ratio invalid | | 12052525 | The attribute max num cannot exceed 3. | | 12052527 | The sale attribute id not exist. | | 12052528 | You can add images to only 1 product variation, which will serve as the primary variation for display in the product options gallery. | | 12052529 | The property value id not exist. | | 12052530 | The warehouse ' {{warehouse ID}} ' does not belong to this shop/seller. | | 12052531 | The warehouse is disabled. | | 12052550 | SKU property must contain all properties | | 12052554 | sku name contain Chinese characters | | 12052570 | product price exceed limit | | 12052574 | unit price config is invalid | | 12052591 | Invalid number of digits of identifier code | | 12052592 | Identifier code already entered, cannot enter the same code twice | | 12052593 | The identifier code cannot be changed once be submitted | | 12052594 | The identifier code type cannot be changed once be submitted | | 12052598 | Only the last digit supports input X | | 12052600 | The identifier code type must be selected | | 12052650 | product qualification image uri illegal | | 12052670 | The size chart image URI is invalid. Note: API users must use the URI generated by the Upload Product Image API. | | 12052673 | Product sizechart image is required | | 12052700 | The seller is inactive. | | 12052701 | do not support cross-boarder seller create local product directly | | 12052702 | seller does not support pre-order | | 12052703 | Invalid seller tax number | | 12052704 | seller id not exist | | 12052901 | The product in its current status is not available for this operation. Change the product status and try again. | | 12052910 | Invalid input parameters. Refer to the API documentation for details. | | 12052912 | No matching category found within your account's main category. Check your main category in the seller profile on Seller Center and ensure your product falls within its scope. | Nội dung này có hữu ích không?Hữu ích Không hữu ích PreviousNext |