添加合作伙伴

商务中心的管理员用户可以使用本接口添加合作伙伴或合作伙伴资产至商务中心。商务中心只能分享其拥有的资产。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3 接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/bc/partner/add/| /v1.3/bc/partner/add/| |请求参数类型|bc_id: number <br>partner_id: number <br>asset_ids: number[] |bc_id: string <br>partner_id: string<br>asset_ids`: string[] |

## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/bc/partner/add/

**方法** POST

**Header**

``` xtable
|字段{30%}|类型{35%}|描述{35%}|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type{必填}|string|请求消息类型。<br>允许值： `"application/json"`。|

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 您的商务中心的 ID。|
| partner_id {必填} | string | 要添加为合作伙伴的商务中心的 ID。|
| asset_type  | string | 要分享给合作伙伴商务中心的资产类型。<br><br>枚举值：`ADVERTISER`（广告账号）。|
| asset_ids | string[] | 要分享给合作伙伴商务中心的资产 ID 列表。<br><br>最大数量：50。|
| advertiser_role | string | 只有在`asset_type` 为`ADVERTISER`时有效。<br><br>授予合作伙伴的广告账号角色。<br><br>枚举值：<ul><li>`ADMIN`：管理员。管理广告账号财务、设置和权限。 创建和编辑广告推广系列并查看投放效果数据。</li><li>`OPERATOR`：操作员。创建和编辑广告推广系列并查看投放效果数据。</li><li>`ANALYST`：分析师。查看广告和投放效果数据。</li></ul><br>`asset_type` 为  `ADVERTISER` 时的默认值：`ANALYST`。|

示例

(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
    "bc_id": "BC_ID",
    "partner_id": "PARTNER_ID",
    "asset_type": "ASSET_TYPE",
    "asset_ids": [
        "ASSET_IDS"
    ],
    "advertiser_role": "ADVERTISER_ROLE",
    "catalog_role": "CATALOG_ROLE"
}' \
https://business-api.tiktok.com/open_api/v1.3/bc/partner/add/
(/code)

返回

|字段|类型|描述|
|--- |--- |--- |
|code |number | 返回码。完整返回码列表及描述，可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string | 返回信息。更多信息可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据。|
|request_id |string|请求的日志ID，唯一标识一个请求。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {}
}
(/code)