创建财务资产组合

您可以使用本接口创建财务资产组合。

请求

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

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|payment_portfolio_name {必填}|string|财务资产组合的名称。|
|advertiser_ids {必填}|string[]|希望与该财务资产组合关联的广告账户列表。<br>仅支持关联与财务资产组合属于同一客户的广告账户。<br><br>最大数量：20。<br><br><ul><li>如果广告账户属于某个商务中心，您需要拥有商务中心的财务经理或管理员权限。若想确认对某个商务中心的权限，可以使用 [/bc/get/](1737115687501826.html) 并检查返回的 `user_role` 和 `finance_role`。</li><li>如果广告账户不属于商务中心，您需要拥有广告账户的管理员或操作员访问权限。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>: 如果 `advertiser_ids` 包含不合法的 ID，整个请求将失败。|
|payment_portfolio_type|string|财务资产组合类型。<br><br>枚举值：<ul><li>`SHARED`：高级财务资产组合。对于高级财务资产组合，资金为集中管理，由所有关联的广告账号共同使用。</li></ul><br>默认值：`SHARED`。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/payment_portfolio/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "payment_portfolio_name": "{{payment_portfolio_name}}",
    "advertiser_ids": ["{{advertiser_id}}", "{{advertiser_id}}", "{{advertiser_id}}"]
}'
(/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| 返回数据。 |
#|payment_portfolio_id|string|财务资产组合的 ID。|
#|payment_portfolio_name|string|财务资产组合的名称。|
#|payment_portfolio_type|string|财务资产组合类型。<br><br>枚举值：<ul><li>`SHARED`：高级财务资产组合。对于高级财务资产组合，资金为集中管理，由所有关联的广告账号共同使用。</li></ul>|

示例

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