← 返回目录
📁 API Reference › BC Payment Portfolios

获取财务资产组合的授权用户

您可以使用本接口检索有权访问财务资产组合的用户列表。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/payment_portfolio/user/get/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|payment_portfolio_id {必填}|string|财务资产组合的 ID。<br>若想获取财务资产组合 ID 的列表,可使用 [/payment_portfolio/get/](1839151931301954.html)。|
|page|integer|当前页数。<br><br>默认值:1。<br>取值范围:≥ 1。|
|page_size|integer|分页大小。<br><br>默认值:10。<br>取值范围:1-50。|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/payment_portfolio/user/get/?payment_portfolio_id={{payment_portfolio_id}}&page=1&page_size=50' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|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| 返回数据。 |
#|users|object[]|有权访问财务资产组合的用户列表。|
##|user_id|string|用户的 ID。|
##|user_name|string|用户的名称。|
#|page_info|object|分页信息。|
##|page|number|当前页码。|
##|page_size|number|分页大小。|
##|total_number|number|结果总数。|
##|total_page|number|总页数。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "page_info": {
            "page": 1,
            "page_size": 50,
            "total_number": 2,
            "total_page": 1
        },
        "users": [
            {
                "user_id": "{{user_id}}",
                "user_name": "{{user_name}}"
            },
            {
                "user_id": "{{user_id}}",
                "user_name": "{{user_name}}"
            }
        ]
    }
}
(/code)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →