API Loạt danh mục

Tài liệu hướng dẫn này mô tả cách dùng API Loạt danh mục:

  • Đối với danh mục quảng cáo danh mục Advantage+ - Dùng API này nếu bạn có danh mục lớn, chẳng hạn như danh mục chứa hàng triệu mặt hàng với danh sách cung ứng thường xuyên thay đổi. Bạn có thể tạo, cập nhật và xóa nhiều mặt hàng bằng một yêu cầu HTTP duy nhất.

  • Đối với danh mục thương mại - Dùng API này nếu bạn cần cập nhật thông tin sản phẩm thường xuyên hơn mức mỗi giờ một lần (nếu không, hãy sử dụng API Nguồn cấp dữ liệu). Bạn có thể cập nhật nhiều mặt hàng bằng một yêu cầu HTTP duy nhất.

Cách thức hoạt động

Sử dụng API Loạt danh mục nếu bạn có danh mục lớn, chẳng hạn như danh mục chứa hàng triệu mặt hàng với danh sách cung ứng thường xuyên thay đổi. Bạn có thể tạo, cập nhật và xóa nhiều mặt hàng bằng một yêu cầu HTTP duy nhất.

API Loạt danh mục bao gồm các điểm cuối sau:

Điểm cuối Mô tả Trong tài liệu hướng dẫn này

POST/{catalog_id}/items_batch

Gửi một loạt yêu cầu (tạo, cập nhật, xóa) cho một danh mục. Dùng cho nhiều đối tượng khác nhau, chẳng hạn như sản phẩm, khách sạn, phòng khách sạn, chuyến bay, điểm đến, bài niêm yết nhà, xe cộưu đãi về xe cộ.

Hỗ trợ tất cả phiên bản MAPI lên đến 3.2.

Gửi thông tin cập nhật về sản phẩm

GET/{catalog_id}/check_batch_request_status

Xem trạng thái của yêu cầu hàng loạt. Sử dụng tên người dùng (được trả về từ một lệnh gọi đến {catalog_id}/batch) và thực hiện lệnh gọi GET.

Hỗ trợ tất cả các phiên bản MAPI trước 3.1.

Xem trạng thái của yêu cầu hàng loạt

POST/{catalog_id}/localized_items_batch

Gửi yêu cầu bản địa hóa hàng loạt cho các mặt hàng hiện có trong danh mục. Loạt đó có thể chứa yêu cầu bản địa hóa (tạo, cập nhật, xóa). Bạn có thể dùng điểm cuối này cho nhiều đối tượng khác nhau, chẳng hạn như sản phẩm, khách sạn, chuyến bay, điểm đến, bài niêm yết nhà, xe cộ.

Hỗ trợ tất cả phiên bản MAPI trước 3.1.

Gửi hàng loạt mặt hàng được bản địa hóa

Bước tiếp theo

Hãy xem hướng dẫn về API Loạt danh mục để biết cách thực hiện các hành động thông thường với API Loạt danh mục.