根据资产获取合作伙伴

商务中心的管理员用户可以使用本接口获取某个资产曾经被分享给的合作伙伴。

v1.2与v1.3版本对比

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

## 请求

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

**方法** GET

**Header**

``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权access_token，可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。  |

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心id |
| asset_type {必填} | string | 资产类型。枚举值：`ADVERTISER`, `CATALOG`。|
| asset_id {必填} | string | 资产ID。 当`asset_type`为`ADVERTISER`时，为广告账号ID；当 `asset_type`为` CATALOG` 时，为商品库ID。|
| filtering | object | 筛选条件 |
#| keyword {必填} | string | 想要筛选的合作伙伴名称关键词。 |
| page | number | 当前页码。默认值：1 |
| page_size | number | 页面大小。默认值：10 |

示例

(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "bc_id=BC_ID" \
--data-urlencode "asset_type=ASSET_TYPE" \
--data-urlencode "asset_id=ASSET_ID" \
--data-urlencode "filtering={\"keyword\": \"KEYWORD\"}" \
--data-urlencode "page=PAGE" \
--data-urlencode "page_size=PAGE_SIZE" \
https://business-api.tiktok.com/open_api/v1.3/bc/asset/partner/get/
(/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|返回数据  |
#|list|object[]|合作伙伴列表|
##|bc_name|string|合作伙伴名|
##|bc_id|string|合作伙伴商务中心ID|
#|page_info |object| 分页信息 |
##|page |number| 当前页数 |
##|page_size|number| 分页大小 |
##|total_number|number| 总数 |
##|total_page|number| 总页数 |
|request_id|string|请求的日志id，唯一标识一个请求  |

示例

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