Danh mục hiện có của người dùng Instagram

Biểu thị bộ sưu tập danh mục sản phẩm trong 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}/available_catalogs

Lấy danh mục sản phẩm trong Cửa hàng trên Instagram của Người dùng Instagram.

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ợ.
Chỉ trả về dữ liệu trên một danh mục vì Cửa hàng trên Instagram được giới hạn ở một danh mục duy nhất.
Danh mục mang tính cộng tác (danh mục của đối tác mua sắm hoặc người sáng tạo nội dung liên kết tiếp thị) không được hỗ trợ.

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}/available_catalogs
  ?fields={fields}
  &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.
`fields`	`{fields}`	Danh sách các trường của danh mục mà bạn muốn nhận được cho từng danh mục trong tập kết quả. Danh sách này được phân tách bằng dấu phẩy.

Phản hồi

Một đối tượng ở định dạng JSON chứa dữ liệu mà bạn yêu cầu.

{
  "data": [
    {
      "catalog_id": "{catalog-id}",
      "catalog_name": "{catalog-name}",
      "shop_name": "{shop-name}",
      "product_count": {product-count}
    }
  ]
}

Nội dung phản hồi

Thuộc tính	Giá trị
`catalog_id`	ID danh mục.
`catalog_name`	Tên danh mục.
`shop_name`	Tên cửa hàng.
`product_count`	Tên sản phẩm trong danh mục. Bao gồm tất cả sản phẩm, bất kể trạng thái xét duyệt.

cURL mẫu

Yêu cầu

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010177253934/available_catalogs?access_token=EAAOc..."

Phản hồi

{
  "data": [
    {
      "catalog_id": "960179311066902",
      "catalog_name": "Jay's Favorite Snacks",
      "shop_name": "Jay's Bespoke",
      "product_count": 11
    }
  ]
}

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ợ.