Tìm kiếm sản phẩm trong danh mục của người dùng Instagram

Biểu thị các sản phẩm và mẫu mã sản phẩm khớp với một chuỗi tìm kiếm nhất định trong danh mục sản phẩm thuộc Cửa hàng trên Instagram của Người dùng Instagram. Hãy xem hướng dẫn Gắn thẻ sản phẩm để biết toàn bộ chi tiết về cách sử dụng.

Tạo

Thao tác này không được hỗ trợ.

Đọc

GET /{ig-user-id}/catalog_product_search

Lấy bộ sưu tập các sản phẩm khớp với một chuỗi tìm kiếm nhất định trong danh mục thuộc Cửa hàng trên Instagram của Người dùng Instagram được nhắm mục tiêu.

Các giới hạn

Tài khoản người sáng tạo nội dung trên Instagram không được hỗ trợ.
Tin, Instagram TV, Reels, Live và Mentions không được hỗ trợ.
Những sản phẩm có review_status là rejected sẽ được trả về. Tuy nhiên, bạn không thể gắn thẻ sản phẩm bị từ chối cho File phương tiện trên Instagram.
Mặc dù API này sẽ không trả về lỗi khi đăng bài viết được gắn thẻ sản phẩm chưa phê duyệt, nhưng thẻ đó sẽ không hiển thị trên bài viết đã đăng cho đến khi sản phẩm được phê duyệt. Do đó, bạn chỉ nên cho phép người dùng ứng dụng đăng bài viết có thẻ sản phẩm mà review_status của sản phẩm này là approved. Theo mặc định, trường này được trả về cho mỗi sản phẩm khi bạn lấy các sản phẩm đủ điều kiện của người dùng ứng dụng.

Yêu cầu

Loại	Yêu cầu
Mã truy cập	Người dùng
Vai trò trong doanh nghiệp	Người dùng ứng dụng phải có vai trò quản trị viên trên Trình quản lý kinh doanh sở hữu Cửa hàng trên Instagram của Người dùng Instagram.
Cửa hàng trên Instagram	Người dùng Instagram phải có Cửa hàng trên Instagram được phê duyệt với một danh mục sản phẩm chứa các sản phẩm.
Quyền	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Nếu người dùng ứng dụng được cấp một vai trò trên Trang đã kết nối với Người dùng Instagram được nhắm mục tiêu qua Trình quản lý kinh doanh, bạn cũng sẽ cần có một trong những quyền sau: `ads_management` `business_management`

Cú pháp yêu cầu

GET https://graph.facebook.com/{api-version}/{ig-user-id}/catalog_product_search
  ?catalog_id={catalog-id}
  &q={q}
  &access_token={access-token}

Thông số đường dẫn

Phần giữ chỗ	Giá trị
`{api-version}`	Phiên bản API.
`{ig-user-id}`	Bắt buộc. ID người dùng trong ứng dụng của người dùng ứng dụng.

Thông số chuỗi truy vấn

Khóa	Phần giữ chỗ	Giá trị
`access_token`	`{access-token}`	Bắt buộc. Mã truy cập người dùng của người dùng ứng dụng.
`catalog_id`	`{catalog-id}`	Bắt buộc. ID của danh mục cần tìm kiếm.
`q`	`{q}`	Chuỗi cần tìm kiếm trong tên hoặc số SKU của từng sản phẩm (có thể thêm số SKU vào cột ID nội dung trong giao diện quản lý danh mục). Nếu không có chuỗi nào được chỉ định, hệ thống sẽ trả về tất cả sản phẩm đủ điều kiện gắn thẻ.

Phản hồi

Đối tượng ở định dạng JSON chứa một mảng sản phẩm đủ điều kiện gắn thẻ và siêu dữ liệu của những sản phẩm này. Hỗ trợ phân trang dựa vào con trỏ.

{
  "data": [
    {
      "product_id": {product-id},
      "merchant_id": {merchant-id},
      "product_name": "{product-name}",
      "image_url": "{image-url}",
      "retailer_id": "{retailer-id}",
      "review_status": "{review-status}",
      "is_checkout_flow": {is-checkout-flow}
    }
  ]
}

Nội dung phản hồi

Thuộc tính	Giá trị
`product_id`	ID sản phẩm.
`merchant_id`	ID người bán.
`product_name`	Tên sản phẩm.
`image_url`	URL hình ảnh sản phẩm.
`retailer_id`	ID nhà bán lẻ.
`review_status`	Trạng thái xét duyệt. Giá trị có thể là `approved`, `outdated`, `pending`, `rejected`. Sản phẩm đã phê duyệt có thể hiển thị trong Cửa hàng trên Instagram của người dùng ứng dụng. Tuy nhiên, trạng thái đã phê duyệt không cho biết tình trạng hàng (ví dụ: sản phẩm có thể hết hàng). Chỉ những thẻ được liên kết với sản phẩm có `review_status` là `approved` mới hiển thị trên bài viết đã đăng.
`is_checkout_flow`	Nếu giá trị là `true` thì có thể mua sản phẩm trực tiếp trong ứng dụng Instagram. Nếu giá trị là `false` thì phải mua sản phẩm trong ứng dụng/trang web của người dùng ứng dụng.
`product_variants`	ID sản phẩm (`product_id`) và tên mẫu mã (`variant_name`) của các mẫu mã sản phẩm.

cURL mẫu

Yêu cầu

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010177253934/catalog_product_search?catalog_id=960179311066902&q=gummy&access_token=EAAOc"

Phản hồi

{
  "data": [
    {
      "product_id": 3231775643511089,
      "merchant_id": 90010177253934,
      "product_name": "Gummy Wombats",
      "image_url": "https://scont...",
      "retailer_id": "oh59p9vzei",
      "review_status": "approved",
      "is_checkout_flow": true,
      "product_variants": [
            {
              "product_id": 5209223099160494
            },
            {
              "product_id": 7478222675582505,
              "variant_name": "Green Gummy Wombats"
            }
          ]
    }
  ]
}

Cập nhật

Thao tác này không được hỗ trợ.

Xóa

Thao tác này không được hỗ trợ.