保存试玩素材

此接口可用于保存试玩素材。

v1.2 与 v1.3 接口对比

下表概述了 v1.2 接口与 v1.3 接口之间的差异。 ``xtable |变更{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/playable/save/|/v1.3/playable/save/| |请求参数类型|advertiser_id: number<br>playable_id: number|advertiser_id: string<br>playable_id: string| |返回参数类型|playable_id: number|playable_id`: string|

## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/playable/save/

**方法** POST

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

参数

| 字段 | 类型 | 描述 |
|---|---|---|
| advertiser_id {必填} | string | 广告主 ID。 |
| playable_id {必填} | string | 试玩素材 ID。 |
| playable_name {必填} | string | 试玩素材名称。 |

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/playable/save/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "playable_id": "{{playable_id}}",
    "playable_name": "{{playable_name}}"
}'
(/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|返回数据。|
#| playable_id | string | 试玩素材 ID。 |
#| playable_url | string | 试玩 URL。 |
#| playable_name | string | 试玩素材名称。 |
#| playable_orientation | string | 试玩素材方向。<br><br>枚举值：<ul><li>`BOTH`：竖版或横版。</li><li>`LANDSCAPE`：横版。</li><li>`PORTRAIT`：竖版。</li></ul>|
#| status | string | 试玩素材状态。<br><br>枚举值：`AUDIT_FAIL`、`AUDIT_SUCCESS`、`VALIDATE_FAIL`、`VALIDATE_SUCCESS`、`VALIDATING`。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "playable_id": "{{playable_id}}",
        "playable_name": "{{playable_name}}",
        "playable_orientation": "BOTH",
        "playable_url": "{{playable_url}}",
        "status": "VALIDATE_SUCCESS"
    }
}
(/code);