创建店铺层级自定义 TikTok 作品

你可以使用本接口创建店铺层级自定义 TikTok 作品。

店铺层级自定义 TikTok 作品通过将你的 TikTok 视频直接在 TikTok Shop 层级关联到商品来生成。如果关联的商品是投放中推广系列的一部分，那么与该商品关联的视频将会添加到该推广系列。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/gmv_max/creation/custom_anchor_video_list/create/

方法 POST

Header

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://business-api.tiktok.com/portal/docs/marketing-api-authentication/v1.3)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许值：`application/json`。|

参数

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|store_id {必填}|string|TikTok Shop 的 ID。<br><br>若想获取可用于 GMV Max 推广系列的 TikTok Shop，可使用 [/gmv_max/store/list/](1822001044479041.html) 并确认返回的 `is_gmv_max_available` 为 `true`。|
|store_authorized_bc_id {必填}|string|有权限访问该 TikTok Shop（`store_id`）的商务中心的 ID。<br><br>如需获取该 ID，可查看 [/gmv_max/store/list/](1822001044479041.html) 返回的 `store_id` 对应的 `store_authorized_bc_id`。|
|custom_anchor_video_list {必填}|object[]|视频及你想要关联的商品的详情。<br><br>通过将视频在 TikTok Shop 层级关联到商品，你可以生成店铺层级自定义 TikTok 作品。如果你使用自动选择创意模式（`product_video_specific_type` 为 `AUTO_SELECTION`）且推广系列包含已关联的商品，系统将自动将这些店铺层级自定义 TikTok 作品添加到你的商品 GMV Max 推广系列（`shopping_ads_type` 设置为 `PRODUCT`）。<br><br>最大数量：200。|
#|item_id {必填}|string|想要在自定义作品中使用的 TikTok 视频的 ID。<br><br>如需获取符合条件的视频，可使用 [/gmv_max/video/get/](https://business-api.tiktok.com/portal/docs/get-posts-for-a-product-gmv-max-campaign/v1.3) 并将 `custom_posts_eligible` 设置为 `true`。|
#|identity_info {必填}|object|与 TikTok 视频关联的广告发布身份（TikTok 账户）的信息。<br><br>如需查找与所提供 TikTok 视频（`item_id`）关联的广告发布身份详情，可查看 [/gmv_max/video/get/](https://business-api.tiktok.com/portal/docs/get-posts-for-a-product-gmv-max-campaign/v1.3) 返回的 `item_id` 对应的 `identity_info`。|
##|identity_id {必填}|string|广告发布身份 ID。|
##|identity_type {必填}|string|广告发布身份类型。<br><br>枚举值：<ul><li>`AUTH_CODE`：授权用户。当您使用授权码访问 TikTok 账户或 TikTok 帖子时，系统将创建此类型的认证身份。</li><li>`TT_USER`：TikTok 用户。当您绑定 TikTok For Business 账户与 TikTok 企业号，或将 TikTok For Business 账户与普通 TikTok 账户绑定后，将 TikTok 账户升级为企业号时，系统将创建此类型的认证身份。</li><li>`BC_AUTH_TT`：添加到商务中心的 TikTok 用户。当您将 TikTok 账号添加到商务中心，并从 TikTok 账号主获得访问批准后，系统将创建此类型的认证身份。</li><li>`TTS_TT`：TikTok Shop 关联的 TikTok 用户。当您为 TikTok Shop 设置官方 TikTok 账号后，系统将创建此类型的认证身份。</li></ul>|
##|identity_authorized_bc_id {+条件必填}|string|仅当 `identity_type` 为 `BC_AUTH_TT` 时，本字段必填。<br><br>与添加到商务中心的 TikTok 用户类型认证身份绑定的商务中心的 ID。|
##|identity_authorized_shop_id {+条件必填}|string|仅当 `identity_type` 为 `BC_AUTH_TT` 且[/gmv_max/identity/get/](1822001101474882.html)为此认证身份返回了 `identity_authorized_shop_id` 字段时，本字段必填。<br><br>与添加到商务中心的 TikTok 用户类型认证身份绑定的 TikTok Shop 的 ID。|
##|store_id {+条件必填}|string|仅当 `identity_type` 为 `TTS_TT` 时，本字段必填。<br><br>与 TikTok Shop 关联的 TikTok 用户类型认证身份绑定的 TikTok Shop 的 ID。|
#|spu_id_list {必填}|string[]|要关联到视频的商品 SPU（标准商品单元） ID。<br><br>最大数量：1。<br><br>如需获取 TikTok Shop 中商品的 SPU ID 列表，可使用 [/store/product/get/](1793482248880130.html)。将 `ad_creation_eligible` 设置为 `GMV_MAX`，并选择 `status` 为 `AVAILABLE` 且 `gmv_max_ads_status` 为 `UNOCCUPIED` 的 `item_group_id` 值。|

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/creation/custom_anchor_video_list/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "store_id": "{{store_id}}",
    "store_authorized_bc_id": "{{store_authorized_bc_id}}",
    "custom_anchor_video_list": [
        {
            "identity_info": {
                "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
                "identity_id": "{{identity_id}}",
                "identity_type": "BC_AUTH_TT"
            },
            "item_id": "{{item_id}}",
            "spu_id_list": ["{{spu_id}}"]
        },
        {
            "identity_info": {
                "identity_id": "{{identity_id}}",
                "identity_type": "TT_USER"
            },
            "item_id": "{{item_id}}",
            "spu_id_list": ["{{spu_id}}"]
        }
    ]
}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述，可查看[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息可查看[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|failure_list|object|未能成功创建的店铺层级自定义 TikTok 作品的列表。|
##|item_id|object[]|你想要在自定义作品中使用的 TikTok 视频的 ID。|
##|identity_info|string[]|与 TikTok 视频关联的广告发布身份（TikTok 账户）的信息。|
###|identity_id|object|广告发布身份 ID。|
###|identity_type|string|广告发布身份类型。<br><br>枚举值：<ul><li>`AUTH_CODE`：授权用户。当您使用授权码访问 TikTok 账户或 TikTok 帖子时，系统将创建此类型的认证身份。</li><li>`TT_USER`：TikTok 用户。当您绑定 TikTok For Business 账户与 TikTok 企业号，或将 TikTok For Business 账户与普通 TikTok 账户绑定后，将 TikTok 账户升级为企业号时，系统将创建此类型的认证身份。</li><li>`BC_AUTH_TT`：添加到商务中心的 TikTok 用户。当您将 TikTok 账号添加到商务中心，并从 TikTok 账号主获得访问批准后，系统将创建此类型的认证身份。</li><li>`TTS_TT`：TikTok Shop 关联的 TikTok 用户。当您为 TikTok Shop 设置官方 TikTok 账号后，系统将创建此类型的认证身份。</li></ul>|
###|identity_authorized_bc_id|string|与添加到商务中心的 TikTok 用户类型认证身份绑定的商务中心的 ID。|
###|identity_authorized_shop_id|string|与添加到商务中心的 TikTok 用户类型认证身份绑定的 TikTok Shop 的 ID。|
###|store_id|string|与 TikTok Shop 关联的 TikTok 用户类型认证身份绑定的 TikTok Shop 的 ID。|
##|spu_id_list|string|要关联到视频的商品 SPU ID。|
##|reason|string|失败原因。<br><br>枚举值：<ul><li>`IDENTITY_NO_PERMISSION`：你没有该广告发布身份所需的权限。</li><li>`INVALID_PARAMETER`：提交了无效参数。</li><li>`AUTH_CODE_CAN_NOT_CHANGE_ANCHOR`：未经用户许可，无法更改视频中的锚点。</li><li>`ITEM_NOT_FOUND`：找不到该 TikTok 视频。</li><li>`NATIVE_ANCHOR_EXISTS`：你要添加的商品链接与视频中已有的商品链接相同。</li></ul>|
##|error_message|string|详细错误信息。|

示例

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