删除卖家

本页面介绍了如何从专人服务合作伙伴广告中删除卖家。

备注:通过市场或零售商出售商品的商家即为卖家。您将卖家加入专人服务合作伙伴广告中后,他们便会成为有专人服务的合作伙伴。为简单起见,本页面将使用“卖家”来指代有专人服务的合作伙伴(即已加入的卖家)。

无法删除正在投放广告系列的卖家。

卖家删除 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/v20.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

无法删除正在投放广告系列的商家。请前往广告管理工具查看商家所投放广告系列的结束时间或将这些广告系列关闭。