Instagram 用户商品申诉

表示未通过审核的商品的申诉状态。如需了解完整的使用详情，请参阅商品标记指南。

创建

POST /{ig-user-id}/product_appeal

对未通过审核的商品提出申诉。

限制

不支持 Instagram 创作者帐户。
不支持快拍、Instagram TV、Reels、Live 和 Mentions。

要求

类型	要求
访问口令	用户
商务管理平台身份	应用用户必须在此 Instagram 用户的 Instagram 店铺所属的商务管理平台上具有管理员身份。
Instagram 店铺	Instagram 用户必须拥有已获批准的 Instagram 店铺，以及包含商品的商品目录。
权限	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` 若在与目标 Instagram 用户相绑定的公共主页上，通过商务管理平台向应用用户授予了身份，您还将需要以下其中一项权限： `ads_management` `business_management`

请求语法

POST https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?appeal_reason={appeal-reason}
  &product_id={product-id}
  &access_token={access-token}

路径参数

占位符	值
`{api-version}`	API 版本。
`{ig-user-id}`	必要项。应用用户的应用范围用户编号。

查询字符串参数

键	占位符	值
`access_token`	`{access-token}`	必要项。应用用户的用户访问口令。
`appeal_reason`	`{appeal-reason}`	必要项。商品应通过审核的原因说明。
`product_id`	`{product-id}`	必要项。商品编号。

响应

表示成功或失败的对象。响应内容不会表示申诉结果。

{
  "success": {success}
}

响应内容

属性	值
`success`	表示 API 是接受请求 (`true`) 还是不接受请求 (`false`)。响应内容不会表示申诉结果。

cURL 示例

请求

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

响应

{
  "success": true
}

读取

GET /{ig-user-id}/product_appeal

获取未通过审核的商品的申诉状态。

限制

不支持 Instagram 创作者帐户。
不支持快拍、Instagram TV、Reels、Live 和 Mentions。

要求

类型	要求
访问口令	用户
商务管理平台身份	应用用户必须在此 Instagram 用户的 Instagram 店铺所属的商务管理平台上具有管理员身份。
Instagram 店铺	Instagram 用户必须拥有已获批准的 Instagram 店铺，以及包含商品的商品目录。
权限	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` 若在与目标 Instagram 用户相绑定的公共主页上，通过商务管理平台向应用用户授予了身份，您还将需要以下其中一项权限： `ads_management` `business_management`

请求语法

GET https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?product_id={product-id}
  &access_token={access-token}

路径参数

占位符	值
`{api-version}`	API 版本。
`{ig-user-id}`	必要项。应用用户的应用范围用户编号。

查询字符串参数

键	占位符	值
`access_token`	`{access-token}`	必要项。应用用户的用户访问口令。
`product_id`	`{product-id}`	必要项。商品编号。

响应

JSON 格式对象，其中包含申诉状态元数据的数组。

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

响应内容

属性值

属性	值
`eligible_for_appeal`	表示是否可以对审核决定提出申诉（如果值为 `true`，则表示可以申诉，如果值为 `false`，则表示不能申诉）。
`product_id`	商品编号。
`review_status`	审核状态。值可以是： `approved` — 商品已通过审核。 `rejected` — 商品未通过审核 `pending` — 仍在审核中。 `outdated` — 商品已通过审核，但经过编辑，需要重新审核。 `""` — 无审核状态。 `no_review` — 无审核状态。

eligible_for_appeal

表示是否可以对审核决定提出申诉（如果值为 true，则表示可以申诉，如果值为 false，则表示不能申诉）。

product_id

商品编号。

review_status

审核状态。值可以是：

approved — 商品已通过审核。
rejected — 商品未通过审核
pending — 仍在审核中。
outdated — 商品已通过审核，但经过编辑，需要重新审核。
"" — 无审核状态。
no_review — 无审核状态。

cURL 示例

请求

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

响应

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

更新

不支持此操作。

删除

不支持此操作。