添加卖家

本页会介绍对于有专人服务的合作伙伴广告 (MPA)，如何使用卖家业务创建 API 添加卖家。

使用卖家资格 API验证卖家有否资格使用 MPA 后，您将使用卖家业务创建 API 添加卖家。

使用合格卖家的 vendor_id 调用卖家业务创建 API，系统会自动执行以下操作：

为卖家创建子商务管理平台、Facebook 公共主页和广告账户
分享额度
以 vendor_id=<child_business_external_id> 作为筛选条件，设置卖家的细分目录

将卖家添加到 MPA 后，他们就会被视为有专人服务的合作伙伴。

前期准备

删除卖家前，请确保您已完成以下步骤：

需要的权限

如要调用卖家业务创建 API，您将需要以下权限：

商务管理平台管理员
目录管理员
管理额度
应用开发者

卖家业务创建 API 调用

请求

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "POST", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses", 
        "name": "<ASYNC_SESSION_NAME>", 
        "body": "child_business_external_id=<VENDOR_ID>&line_of_credit_id=<LINE_OF_CREDIT_ID>&credit_limit=<CREDIT_LIMIT>&partition_type=<PARTITION_TYPE>&catalog_id=<PARENT_CATALOG_ID>&ad_account_currency=<AD_ACCOUNT_CURRENCY>&seller_targeting_countries=['COUNTRY_CODE1','COUNTRY_CODE2']&timezone_id=<TIMEZONE_ID>&name=<BUSINESS_MANAGER_NAME>&seller_external_website_url=<SELLER_EXTERNAL_WEBSITE_URL>&partner_facebook_page_url=<PARTNER_FACEBOOK_PAGE_&page_profile_image_url=<PROFILE_PIC_URL>&vertical=<VERTICAL>&partner_registration_countries=<PARTNER_REGISTRATION_COUNTRY>"
      } 
  ]' \
  "https://graph.facebook.com/v21.0"

系统将立即返回对此 API 调用的响应，响应中包含 ASYNC_SESSION_ID。在继续处理请求的同时，系统应该会持续轮询 ASYNC_SESSION_ID，直到达到终端状态 [COMPLETED|FAILED]。

参数

名称	描述
`ad_account_currency` 字符串	必要。为卖家创建的广告账户的货币。字符串输入应为货币缩写。请参阅每月帐单可接受的货币。
`catalog_id` 数字字符串	必要。市场目录（称为主目录）的编号。执行添加流程时，您可以使用 `vendor_id=<child_business_external_id>` 筛选此目录，从而为卖家创建细分目录。
`child_business_external_id` 字符串	必要。每个市场都应为每个卖家传递一个唯一的编号。市场端的字段名称是 `vendor_id`。此字段用于创建带筛选条件 `vendor_id = <child_business_external_id>` 的细分目录。
`credit_limit` 数字字符串	必要。与主 line_of_credit_id 中的卖家共享的最大额度。您应该只在 `partition_type` 值设为 `FIXED` 时设置此参数条件：`line_of_credit_id` 中的可用额度 >= 申请的 `credit_limit`。
`partition_type` 枚举字符串	必要。设置为下列值之一： `FIXED` `AUTH` 默认值：`FIXED` 固定委托额度或无限制委托额度。如果 `partition_type` 值设置为 `AUTH`，则 `credit_limit` 参数的值应设为 ignored
`line_of_credit_id` 数字字符串	必要。您可以与卖家共享其中额度的主要额度的编号。条件：传递参数 `credit_limit` 和 `ad_account_currency`。无法传递 `no_ad_account`
`marketplace_bm_id` 字符串	必要。市场的商务管理平台编号。详情请参阅在 Meta 商务管理平台查找业务编号。
`name` 字符串	必要。为卖家创建的唯一商务管理平台名称。
`skip_partner_page_creation` 布尔值	非必要。设置 `true`，跳过卖家的公共主页创建。默认值：`false`
`page_name` 字符串	选填。分配给为卖家创建的公共主页的名称。在以下情况下跳过设置此参数：`skip_partner_page_creation` 设为 `true`。条件：公共主页名称必须符合 Facebook 的公共主页名称要求。默认值：在合作中心的有专人服务的合作伙伴广告 API 添加期间配置的合作伙伴的 Facebook 公共主页名称。
`page_profile_image_url` 字符串	选填。从中获取作为卖家公共主页头像的图片网址。在以下情况下跳过设置此参数：`skip_partner_page_creation` 设为 `true`。条件：图像尺寸 >= 180180 像素图片大小 < 1MB 默认值：*在协作中心的有专人服务的合作伙伴广告 API 添加期间配置的合作伙伴的 Facebook 公共主页头像。
`seller_external_website_url` 字符串	必要。卖家的网址。
`seller_targeting_countries` list<string>	必要。包含卖家目标国家/地区的字符串数组。此值是国家/地区代码，而不是国家/地区名称。在创建广告期间，这将用作广告组中的默认定位国家/地区。参考国家/地区代码。
`partner_facebook_page_url` 字符串	选填。卖家的 Facebook 公共主页网址。
`partner_registration_countries` 字符串	必要。卖家的商业注册国家/地区。此值是国家/地区代码，而不是国家/地区名称。参考国家/地区代码。
`timezone_id` 数字字符串	必要。企业/广告账户的时区编号。请参阅时区编号。
`vertical` 枚举字符串	必要。设置为下列值之一： `ADVERTISING` `AUTOMOTIVE` `CONSUMER_PACKAGED_GOODS` `ECOMMERCE` `EDUCATION` `ENERGY_AND_UTILITIES` `ENTERTAINMENT_AND_MEDIA` `FINANCIAL_SERVICES` `GAMING` `GOVERNMENT_AND_POLITICS` `MARKETING` `ORGANIZATIONS_AND_ASSOCIATIONS` `PROFESSIONAL_SERVICES` `RETAIL` `TECHNOLOGY` `TELECOM` `TRAVEL` `OTHER`

响应

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

使用 ASYNC_SESSION_ID 可获取添加到有专人服务的合作伙伴广告的某个卖家的相应编号。

详情请参阅如何轮询异步会话以获取响应。

成功响应

如果状态是 COMPLETED，轮询异步会话得到的数据将如下所示：

{
  "result": "{\"id\":\"<NEWLY_CREATED_MANAGED_PARTNER_BM_ID>\"}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

失败响应

如果状态是 FAILED，轮询异步会话得到的数据将如下所示：

错误代码

向卖家添加 API 发出的请求可能会产生多种不同的错误响应。详情请参阅如何处理错误。

错误代码	错误子代码	错误消息
1800000	2310114	请在合作中心完成有专人服务的合作伙伴广告添加流程
1800001	2310118	供应商编号 {vendor_id} 已在使用中。输入一个未使用的唯一供应商编号。
1800002	2310138	商家名称 {invalid_business_name} 不是有效名称。请考虑改用 {suggested_business_name}。企业名称必须符合 Facebook 的企业名称要求。
1800002	2310139	商家名称 {invalid_business_name} 不是有效名称。企业名称必须符合 Facebook 的企业名称要求。
1800003	2310133	为该合作伙伴的业务输入有效的注册国家/地区代码
1800004	2310127	移除或更新合作伙伴注册国家/地区列出的以下无效国家/地区代码：[{invalid_registration_country_codes}]
1800006	2310141	移除或更新您输入的以下无效国家/地区代码：[{invalid_targeting_country_codes}]
1800100	2310117	您输入的目录编号 {catalog_id} 不能用于创建细分目录。您可以前往电商合作伙伴，查找包含此合作伙伴商品的正确目录编号。请使用正确的目录编号，重新尝试添加合作伙伴。
1800101	2310116	您的商家 {business_id} 不管理您输入的目录编号 {catalog_id}。请输入由您商家管理的目录编号。
1800102	2310115	检查您输入的目录 ID {catalog_id}。如果该编号正确无误，且您需要访问此目录，请让拥有完全控制权的用户前往商务管理平台的“业务设置”部分，并向您授予权限。分配后，重新尝试添加合作伙伴。
1800200	2310119	输入您将用来与合作伙伴共享额度的额度编号
1800201	2310144	您输入的额度编号 {line_of_credit_id} 不是结算账户或额度编号。输入与业务编号 {marketplace_business_id} 关联的额度编号。这应该是您的企业用于与合作伙伴分享额度的额度。
1800202	2310122	检查您输入的额度编号 {line_of_credit_id}。如果该编号正确无误，且您需要访问权限，请让拥有完全控制权的用户前往商务管理平台的“业务设置”部分，并向您授予财务管理权限。获得财务管理权限后，请重新尝试添加合作伙伴。
1800203	2310123	您的企业 {business_id} 不管理输入的额度 {line_of_credit_id}。提供由您的企业管理的发票账户或额度编号。
1800204	2310120	输入广告账户的货币。此设置以后无法更改。
1800205	2310145	额度编号 {line_of_credit_id} 不支持输入的货币 {ad_account_currency}。将合作伙伴的广告账户货币更新为额度支持的其中一种货币。
1800206	2310121	输入大于 0 的额度
1800207	2310143	您输入的额度 ${credit_limit} 高于可用额度余额 ${available_credit}。降低分配的额度或使用余额更高的其他额度编号。
1800305	2310149	输入合作伙伴头像的图片网址。图像像素应不低于 180 x 180，且大小小于 1 MB。
1800306	2310150	图像像素应不低于 180 x 180，且大小小于 1 MB。检查图片大小和网址 {page_profile_image_url}，然后重试或输入新的图片网址。
1800306	2310151	检查链接 {page_profile_image_url} 或输入新链接
1800307	2310148	系统尝试处理图像网址 {page_profile_image_url} 时超时。检查图片网址，重试请求或输入新的图片网址。
1800311	2310181	公共主页名称 {invalid_page_name} 不是有效名称。请考虑使用 {suggested_page_name}。公共主页名称必须符合 Facebook 的公共主页名称要求。
1800311	2310182	公共主页名称 {invalid_page_name} 不是有效名称。公共主页名称必须符合 Facebook 的公共主页名称要求。