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

Để gửi thông tin mới về mặt hàng được bản địa hóa, hãy sử dụng điểm cuối /{catalog_id}/localized_items_batch.

Để tạo, cập nhật hoặc xóa các sản phẩm được bản địa hóa 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>/localized_items_batch?requests=<REQUESTS> 

Thông số

Thiết lập danh mục được bản địa hóa chứa danh sách các ngôn ngữ và quốc gia được hỗ trợ để ghi đè danh mục, cũng như các ví dụ về loại và giá trị ghi đè khi bản địa hóa theo LANGUAGE, COUNTRY HOẶC LANGUAGE_AND_COUNTRY. Hãy xem phần Trường được hỗ trợ - Danh mục được bản địa hóa để biết danh sách các trường được hỗ trợ trong danh mục.

Giới hạn

• Thông số requests có thể chứa tối đa 1.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 danh sách các trường được hỗ trợ và nội dung mô tả tương ứng cho từng trường, đối với điểm cuối /{catalog_id}/localized_items_batch:

• Sản phẩm + Mô tả
• Khách sạn + Mô tả
• Chuyến bay + Mô tả
• Điểm đến + Mô tả
• Bài niêm yết nhà + Mô tả
• Xe cộ + Mô tả

Xem thêm

• Danh sách đầy đủ các trường được hỗ trợ trong danh mục
• Loạt mặt hàng được bản địa hóa trong danh mục sản phẩm, Tài liệu tham khảo

Ví dụ

Yêu cầu mẫu

POST /{catalog_id}/*localized_items_batch*
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "localization": {
        "type": "LANGUAGE",
        "value": "fr_XX"
      },
       "data": {
         "id": "retailer-2",
         "title": "C'est un tshirt",
         "description": "Le t-shirt a un joli motif",
         "link": "http://www.fr.example.com/t-shirts/1.png"
       }
    },
    {
      "method": "CREATE",
      "localization": {
        "type": "COUNTRY",
         "value": "FR"
      },
       "data": {
         "id": "retailer-2",
         "availability": "in stock",
         "price": "9.99 EUR"
       }
    },
    {
      "method": "UPDATE",
      "localization": {
        "type": "LANGUAGE",
        "value": "fr_XX"
      },
      "data": {
        "id": "retailer-3",
        "availability": "out of stock",
        "link": "http://www.fr.example.com/t-shirts/2.png"
      }
    },
    {
      "method": "UPDATE",
      "localization": {
        "type": "COUNTRY",
        "value": "FR"
      },
      "data": {
        "id": "retailer-3",
        "price": "19.99 USD"
      }
    },
    {
      "method": "DELETE",
      "localization": {
        "type": "COUNTRY",
        "value": "FR"
      },
      "data": {
        "id": "retailer-4"
      }
    }
  ]
}

Phản hồi mẫu

"handles": ["AczBWxwCxXv4s3xQpm0JwXBlhs-IPGatrWmDRBmc1wTYrV5JvtkuQRT_FOCmKZGmHvotvvX8UtQnwEgg16wTx14cqPYzWVzmxZiaZDLgMUmjSA"]

Liên kết sâu

Bạn có thể dùng trường applink để chỉ định thông tin liên kết sâu; trường này hoạt động tương tự như Liên kết sâu. Hãy cung cấp thông tin liên kết sâu ở định dạng JSON như minh họa bên dưới.

"applink" : {"ios": [{"url":"example-ios://electronic","app_store_id":42,"app_name":"Electronic Example iOS"}],"iphone": [{"url":"example-iphone://electronic","app_store_id":43,"app_name":"Electronic Example iPhone"}],"ipad": [{"url":"example-ipad://electronic","app_store_id":44,"app_name":"Electronic Example iPad"}],"android": [{"url":"example-android://electronic","package":"com.electronic","class":"com.electronic.Example","app_name":"Electronic Example Android",}],"windows_phone": [{"url":"example-windows://electronic","app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0","app_name":"Electronic Example Windows"}]}

Để bản địa hóa các trường applink, bạn phải cung cấp tất cả những trường đó. Tìm hiểu thêm về liên kết sâu đến sản phẩm.

Tìm hiểu thêm

• Gửi thông tin mới về sản phẩm - /{catalog_id}/items_batch

  • Tổng quan
  • Trường được hỗ trợ
  • Loạt mặt hàng trong danh mục sản phẩm, Tài liệu tham khảo
• Xem trạng thái của yêu cầu hàng loạt - /{catalog_id}/check_batch_request_status

  • Tổng quan
  • Trường được hỗ trợ
  • Xem trạng thái của yêu cầu hàng loạt đối với danh mục sản phẩm, Tài liệu tham khảo
• Danh mục

  • Danh mục sản phẩm, Tài liệu tham khảo
  • Thiết lập danh mục được bản địa hóa, Trường được hỗ trợ - Danh mục được bản địa hóa