Chuyển tới nội dung chính

POST Search Global Products

Tìm kiếm Global Products Seller Scope yêu cầu: seller.global_product.info Lấy danh sách các global product đáp ứng các điều kiện đã chỉ định. API này chỉ trả về các thuộc tính sản phẩm chính. Bạn có thể truyền global product ID được trả về vào Get Global Product API

để lấy thêm chi tiết về sản phẩm. Phiên bản 202312

POST/product/202312/global_products/search

Request

Header

PropertiesTypeDescription
content-type RequiredstringLoại được cho phép: application/json
x-tts-access-token RequiredstringGiá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller.

Query

PropertiesTypeDescription
app_key RequiredstringMỗ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 RequiredstringChữ ký được tạo bởi thuật toán gen. Khi bạn gửi API request đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trong tất cả các API request. Developer có thể sử dụng để chuyển đổi sang giờ địa phương.
page_size RequiredintSố lượng kết quả được trả về trên mỗi trang. Phạm vi hợp lệ: [1-100]
page_tokenstringMột token mờ (opaque) được dùng để lấy trang tiếp theo của tập kết quả phân trang. Lấy giá trị này từ kết quả next_page_token của response trước đó. Không cần thiết cho trang đầu tiên.

Body

PropertiesTypeDescription
statusstringLọc global products theo trạng thái của chúng.Các giá trị có thể có:- PUBLISHED- UNPUBLISHED- DRAFT- DELETED
seller_skus[]stringLọc global products theo các mã seller SKU này.
create_time_geintLọc global products để chỉ hiển thị những sản phẩm được tạo vào hoặc sau ngày giờ đã chỉ định. Unix timestamp.Lưu ý:"create_time_ge" và "create_time_le" cùng nhau tạo thành điều kiện lọc theo thời gian tạo.- Nếu "create_time_ge" được điền nhưng "create_time_le" để trống, "create_time_le" sẽ mặc định là thời gian hiện tại.- Nếu "create_time_le" được điền nhưng "create_time_ge" để trống, "create_time_ge" sẽ mặc định là thời gian sớm nhất của shop.
create_time_leintLọc global products để chỉ hiển thị những sản phẩm được tạo vào hoặc trước ngày giờ đã chỉ định. Unix timestamp.Tham khảo ghi chú trong "create_time_ge" để biết thêm thông tin sử dụng.
update_time_geintLọc global products để chỉ hiển thị những sản phẩm được cập nhật vào hoặc sau ngày giờ đã chỉ định. Unix timestamp.Lưu ý:Các trường "update_time_ge" và "update_time_le" cùng nhau xác định điều kiện lọc theo thời gian cập nhật.- Nếu "update_time_ge" được điền nhưng "update_time_le" để trống, "update_time_le" sẽ mặc định là thời gian hiện tại.- Nếu "update_time_le" được điền nhưng "update_time_ge" để trống, "update_time_ge" sẽ mặc định là thời gian sớm nhất của shop.
update_time_leintLọc global products để chỉ hiển thị những sản phẩm được cập nhật vào hoặc trước ngày giờ đã chỉ định. Unix timestamp.Tham khảo ghi chú trong update_time_ge để biết thêm thông tin sử dụng.

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại được trả về trong API response.
messagestringThông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message.
request_idstringRequest log
dataobjectThông tin trả về cụ thể

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | 12019015 | The number of SKU exceed the limit | | 12019108 | page number is invalid | | 12019109 | page size is invalid | | 12019118 | search create time invalid | | 12019119 | search update time invalid | | 12052032 | The product does not exist | | 12052180 | The total number of search results can not exceed 10000. | | 12052700 | The seller is inactive. | | 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. | | 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