Gửi thông tin mới về sản phẩm

Để gửi thông tin mới về sản phẩm, hãy sử dụng điểm cuối /{catalog_id}/items_batch.

Để tạo, cập nhật hoặc xóa sản phẩm trong danh mục, hãy thực hiện lệnh gọi HTTP POST đến:

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/items_batch?requests=<REQUESTS>
Thông số Loại Mô tả

allow_upsert

boolean

Không bắt buộc: đặt thông số này là true nếu bạn muốn chặn các yêu cầu cập nhật không cho tạo mặt hàng mới.

Khi thông số này được đặt là false, hệ thống sẽ không hoàn tất các yêu cầu cập nhật đối với mặt hàng không có trong danh mục. Nếu không, mặt hàng mới sẽ được tạo.

item_type

enum

Loại mặt hàng trong yêu cầu. Giá trị: DESTINATION, FLIGHT, HOME_LISTING, HOTEL, HOTEL_ROOM, PRODUCT_ITEM, VEHICLE, VEHICLE OFFER.

requests

object

Đối tượng JSON chứa tất cả yêu cầu.

requests.data

object

Đối tượng JSON chứa các trường và giá trị cho một sản phẩm.

  • Khi phương thức là CREATE, đối tượng này phải chứa mọi trường bắt buộc đối với item_type đã chỉ định.
  • Khi phương thức là UPDATE, đối tượng này có thể chứa bất kỳ trường nào.

Lưu ý: Xem các Trường được hỗ trợ mà bạn có thể chuyển.

requests.method

string

CREATE, UPDATE, DELETE

Để biết thêm chi tiết, hãy xem tài liệu tham khảo về API.

Giới hạn

  • Thông số requests có thể chứa tối đa 5.000 mặt hàng.
  • Đối với mỗi danh mục, bạn có thể thực hiện số lượng lệnh gọi mỗi giờ được xác định theo công thức giới hạn tốc độ đối với trường hợp sử dụng Loạt danh mục cho doanh nghiệp. Nếu bạn thấy không đủ, vui lòng liên hệ với chúng tôi.
  • Mã lỗi 1 kèm theo thông báo "Please reduce the amount of data you're asking for, then retry your request" cho biết rằng kích thước dữ liệu (tính bằng byte) nhận được trong yêu cầu API quá lớn. Để khắc phục vấn đề này, vui lòng giảm bớt số lượng mặt hàng trong loạt mặt hàng rồi thử lại. Việc này sẽ đảm bảo rằng kích thước yêu cầu nằm trong giới hạn được chấp nhận và hệ thống có thể xử lý thành công yêu cầu.

Trường được hỗ trợ

Hãy xem các trường được hỗ trợ cho điểm cuối /{catalog_id}/items_batch: