IG 用戶商品申訴

代表禁止刊登商品的申訴狀態。如需完整的用法詳細資訊，請參閱商品標註指南。

建立

POST /{ig-user-id}/product_appeal

針對禁止刊登的商品提出申訴。

限制

不支援 Instagram 創作者帳號。
不支援限時動態、Instagram TV、Reels、Live 和 Mentions。

必備條件

類型	條件
存取權杖	用戶
企業角色	應用程式用戶在擁有 IG 用戶的 Instagram 商店的企業管理平台上，必須具有管理員角色。
Instagram 商店	IG 用戶必須擁有獲得批准的 Instagram 商店，以及包含商品的商品目錄。
權限	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` 如果應用程式用戶是透過連結至目標 IG 用戶之粉絲專頁的企業管理平台獲得角色，您還需要下列其中一項： `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。

必備條件

類型	條件
存取權杖	用戶
企業角色	應用程式用戶在擁有 IG 用戶的 Instagram 商店的企業管理平台上，必須具有管理員角色。
Instagram 商店	IG 用戶必須擁有獲得批准的 Instagram 商店，以及包含商品的商品目錄。
權限	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` 如果應用程式用戶是透過連結至目標 IG 用戶之粉絲專頁的企業管理平台獲得角色，您還需要下列其中一項： `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
    }
  ]
}

更新

不支援執行此作業。

刪除

不支援執行此作業。