Instagram 用戶商品申訴

表示未通過批准的商品之申訴狀態。如需了解完整的使用詳情，請參閱商品標註功能指南。

建立

POST /{ig-user-id}/product_appeal

對未通過批准的商品提出申訴。

限制

不支援 Instagram 創作者帳戶。
不支援限時動態、Instagram TV、Reels、Live 和提及功能。

必要條件

類型	必要條件
存取憑證	用戶
企業角色	應用程式用戶必須在擁有此 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 和提及功能。

必要條件

類型	必要條件
存取憑證	用戶
企業角色	應用程式用戶必須在擁有此 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
    }
  ]
}

更新

不支援這項操作。

刪除

不支援這項操作。