获取合作伙伴资产
商务中心的管理员用户可以使用本接口获取分享给合作伙伴的资产以及由合作伙伴分享的资产。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3 接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/bc/partner/asset/get/| /v1.3/bc/partner/asset/get/
|请求参数类型|bc_id: number<br>partner_id: number|bc_id: string <br>partner_id: string|
|返回参数类型|asset_id: number |asset_id: string|
|新增返回参数|/|advertiser_account_type`: string|
## 请求
**地址**
https://business-api.tiktok.com/open_api/v1.3/bc/partner/asset/get/
**方法** GET
**Header**
``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|bc_id {必填} | string | 商务中心 ID。|
| partner_id {必填} | string | 合作伙伴商务中心 ID。|
|asset_type {必填} | string | 资产类型。<br><br>枚举值：`ADVERTISER`，`CATALOG`。|
|share_type {必填} | string | 分享类型。<br><br>枚举值：<ul><li>`SHARED`: 合作伙伴分享给您的资产。</li><li>`SHARING`: 您分享给合作伙伴的资产。</li></ul> |
|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 "partner_id=PARTNER_ID" \
--data-urlencode "asset_type=ASSET_TYPE" \
--data-urlencode "share_type=SHARE_TYPE" \
--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/partner/asset/get/
(/code)
返回
|字段|类型|描述|
|---|---|---|
|code |number | 返回码。完整返回码列表及描述，可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string | 返回信息。更多信息可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string|请求的日志ID，唯一标识一个请求。|
|data |object|返回数据。|
#| list | object[] | 合作伙伴资产列表。 |
##| asset_id | string | 资产 ID。<ul><li>如果`asset_type`为`ADVERTISER`，表示这是一个广告账户 ID。 <li>如果`asset_type`为`CATALOG`，表示这是一个商品库 ID。 |
##| asset_type | string | 资产类型。<br><br>枚举值：`ADVERTISER`，`CATALOG`。|
##| asset_name | string | 资产名称。 |
##| advertiser_role | string | 只有当`asset_type` 为`ADVERTISER`时返回。<br><br>授予合作伙伴的广告账号角色。<br><br>枚举值： `ADMIN`, `OPERATOR`, `ANALYST`。|
##|advertiser_account_type |string|广告账户类型。<br><br>枚举值：`RESERVATION` （合约广告账户），`AUCTION`（竞价广告账户）。|
##| catalog_role | string | 只有当`asset_type` 为 `CATALOG`时返回。<br><br>授予合作伙伴的商品库角色。<br><br>枚举值：<ul><li>`ADMIN`: 商务中心用户拥有商品库的管理权限。</li><li>`AD_PROMOTE`: 商务中心用户只能使用商品库进行推广活动。 </li></ul> |
#|page_info|object|分页信息。|
##|page|number| 当前页码。 |
##|page_size|number|页面大小。|
##|total_number|number|结果总数。|
##|total_page|number|总页数。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {}
}
(/code)