分享创意资产

您可以使用本接口与其他广告主分享创意资产。
您必须是广告账户和您分享创意资产的广告账户的管理员或操作员用户。同时，您需要为创意资产的所有者。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/creative/asset/share/

方法 POST

Header

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

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id{必填}|string|执行操作的广告主ID。|
|asset_type|string|您想要分享的创意资产类型。<br>枚举值：`VIDEO`, `IMAGE`, `MUSIC`<br>默认值：`VIDEO`|
|material_ids{必填}|string[]|素材ID。 最大数量：20。<br>分享操作成功后，分享的创意素材的名字将被复制到被分享的广告账户下。<br><p><span style="color:darkred"><b>注意</b></span>: 目前，仅当被分享的广告账户下有某素材与被分享素材同名时，分享操作才会失败。|
|shared_advertiser_ids{必填}|string[]|您想要分享给的广告主ID。<br>最大数量：10。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/asset/share/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "advertiser_id": "{{advertiser_id}}",
    "asset_type": "MUSIC",
    "material_ids": ["{{material_id}}", "{{material_id}}"],

    "shared_advertiser_ids": ["{{shared_advertiser_id}}", "{{shared_advertiser_id}}"]
}'
(/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|返回数据。|
#|failed_infos|map < string, string>|失败分享的信息。 <br><p><span style="color:darkred"><b>注意</b></span>: 目前，仅当被分享的广告账户下有某素材与被分享素材同名时，分享才会失败。|
##|key|string|分享失败的广告主ID。|
##|value|string[]|分享失败的素材ID。 |
|request_id |string|请求的日志 ID，唯一标识一个请求。|

示例

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "failed_infos": {
            "×××××××××××××××": [
                "×××××××××××××××",
                "×××××××××××××××"
            ],
            "×××××××××××××××": [
                "×××××××××××××××",
                "×××××××××××××××"
            ]
        }
    }
}
(/code);