Kháng nghị về sản phẩm của người dùng Instagram

Biểu thị trạng thái kháng nghị của một sản phẩm bị từ chối. 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

POST /{ig-user-id}/product_appeal

Kháng nghị sản phẩm bị từ chối.

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

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

POST https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?appeal_reason={appeal-reason}
  &product_id={product-id}
  &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.
`appeal_reason`	`{appeal-reason}`	Bắt buộc. Giải thích lý do sản phẩm cần được phê duyệt.
`product_id`	`{product-id}`	Bắt buộc. ID sản phẩm.

Phản hồi

Đối tượng cho biết thành công hay thất bại. Phản hồi không cho biết kết quả kháng nghị.

{
  "success": {success}
}

Nội dung phản hồi

Thuộc tính	Giá trị
`success`	Cho biết API chấp nhận yêu cầu (`true`) hay không chấp nhận yêu cầu (`false`). Phản hồi không cho biết kết quả kháng nghị.

cURL mẫu

Yêu cầu

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/product_appeal?appeal_reason=product%20is%20a%20toy%20and%20not%20a%20real%20weapon&product_id=4382881195057752&access_token=EAAOc..."

Phản hồi

{
  "success": true
}

Đọc

GET /{ig-user-id}/product_appeal

Lấy trạng thái kháng nghị của sản phẩm bị từ chối.

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

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}/product_appeal
  ?product_id={product-id}
  &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.
`product_id`	`{product-id}`	Bắt buộc. ID sản phẩm.

Phản hồi

Đối tượng ở định dạng JSON chứa một mảng siêu dữ liệu trạng thái kháng nghị.

{
  "data": [
    {
      "eligible_for_appeal": {eligible-for-appeal},
      "product_id": {product-id},
      "review_status": "{review-status}"
    }
  ]
}

Nội dung phản hồi

Thuộc tính Giá trị

Thuộc tính	Giá trị
`eligible_for_appeal`	Cho biết liệu có thể kháng nghị quyết định hay không (có nếu giá trị là `true`, không nếu giá trị là `false`).
`product_id`	ID sản phẩm.
`review_status`	Trạng thái xét duyệt. Giá trị có thể là: `approved` - Sản phẩm được phê duyệt. `rejected` - Sản phẩm đã bị từ chối `pending` - Vẫn đang xét duyệt. `outdated` - Sản phẩm đã được phê duyệt nhưng chưa được chỉnh sửa và cần phải phê duyệt lại. `""` - Không có trạng thái xét duyệt. `no_review` - Không có trạng thái xét duyệt.

eligible_for_appeal

Cho biết liệu có thể kháng nghị quyết định hay không (có nếu giá trị là true, không nếu giá trị là false).

product_id

ID sản phẩm.

review_status

Trạng thái xét duyệt. Giá trị có thể là:

approved - Sản phẩm được phê duyệt.
rejected - Sản phẩm đã bị từ chối
pending - Vẫn đang xét duyệt.
outdated - Sản phẩm đã được phê duyệt nhưng chưa được chỉnh sửa và cần phải phê duyệt lại.
"" - Không có trạng thái xét duyệt.
no_review - Không có 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/product_appeal?product_id=4029274203846188&access_token=EAAOc..."

Phản hồi

{
  "data": [
    {
      "product_id": 4029274203846188,
      "review_status": "approved",
      "eligible_for_appeal": false
    }
  ]
}

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