刪除賣家

本頁面說明如何從合約合作夥伴廣告刪除賣家。

注意：透過網路市集或零售商銷售產品的商家即稱為賣家。一旦您將賣家加入合約合作夥伴廣告，他們即被視為合約合作夥伴。為簡單起見，本頁面將使用「賣家」來指稱合約合作夥伴廣告（即已加入的賣家）。

無法刪除正在進行廣告行銷活動的賣家。

賣家刪除 API 會停用廣告帳號，並刪除在加入期間建立的任何資產，包括：

目錄子集
粉絲專頁
系統用戶
商家

成功刪除後，該賣家的相關 vendor_id 可重複使用，如果需要，可指派給其他賣家。

準備工作

刪除賣家之前，請確認您已完成以下步驟：

必要權限

若要呼叫賣家刪除 API，您將需要下列權限：

企業管理平台管理員
管理額度
應用程式開發人員

賣家刪除 API 呼叫

要求

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "DELETE", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses?child_business_external_id=<VENDOR_ID>", 
        "name": "<ASYNC_SESSION_NAME>"
      } 
  ]' \
  -F "appsecret_proof=<APP_SECRET>" \
  "https://graph.facebook.com/v21.0"

對 API 呼叫的回應會附帶 ASYNC_SESSION_ID 立即傳回。在繼續處理要求時，應輪詢 ASYNC_SESSION_ID，直到達到最終狀態 [COMPLETED|FAILED]。

參數

名稱	說明
`appsecret_proof` 字串	必要項目。用來證明所提供之存取權杖所有權的十六進位字串。`appsecret_proof` 應從網路市集的存取權杖和應用程式密鑰產生。
`child_business_external_id` 字串	除非已提供 `child_business_id`，否則此為必要項目。每個網路市集都應該為每個賣家傳遞一個專屬編號。此欄位在網路市集端的名稱為 `vendor_id`。
`child_business_id` 字串	除非已提供 `child_business_external_id`，否則此為必要項目。賣家的企業管理平台編號。
`marketplace_bm_id` 字串	必要項目。網路市集的企業管理平台編號。請參閱在 Meta 企業管理平台找出企業管理平台編號，瞭解更多資訊。

回應

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

使用 ASYNC_SESSION_ID 取得從合約合作夥伴廣告刪除賣家的狀態。

請參閱如何輪詢非同步連線階段以取得回應，瞭解更多資訊。

成功回應

如果狀態為 COMPLETED，則輪詢非同步連線階段所產生的資料如下所示：

{
  "result": "{\"id\":\"<MANAGED_PARTNER_BM_ID>\", \"success\":true}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

失敗回應

如果狀態為 FAILED，則輪詢非同步連線階段所產生的資料如下所示：

錯誤代碼

對賣家刪除 API 發出的要求可能會產生數種不同的錯誤回應。請參閱如何處理錯誤，瞭解更多資訊。

錯誤代碼	錯誤子代碼	錯誤訊息
1800007	2310162	您輸入的企業管理平台編號 {business_id} 不適用於合約合作夥伴廣告中的合作夥伴。請檢查您輸入的編號，或輸入新的企業管理平台編號。
1800007	2310163	您輸入的廠商編號 {vendor_id} 不適用於合約合作夥伴廣告中的合作夥伴。請檢查您輸入的編號，或輸入新的廠商編號。
1800008	2310164	您的商家並未管理您嘗試刪除的合作夥伴 {business_id OR vendor_id}。請檢查該編號，或輸入新的編號。
1800009	2310113	無法刪除企業管理平台編號為 {business_id} 的合約合作夥伴。其仍有未付款項 {amount} {currency}，無法刪除。請在匯寄發票款項後，再重試刪除合作夥伴。
1800009	2310134	粉絲專頁 {page_id} 的粉絲專頁擁有者 {page_owner_id} 不是管理員系統用戶。該粉絲專頁不是由合約合作夥伴廣告所建立，需要先將其刪除，才能刪除合作夥伴。
1800009	2310135	此合作夥伴擁有一或多個不是由合約合作夥伴廣告建立的 Facebook 粉絲專頁。需要先刪除這些粉絲專頁，才能刪除合作夥伴：{list_of_page_ids}
1800009	2310165	商家仍有進行中的行銷活動，無法刪除。請前往廣告管理員，查看進行中的行銷活動何時結束，或將其關閉。