获取音乐版权信息
您可以使用本接口获取某个认证身份下的音乐版权信息。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/identity/music/authorization/| /v1.3/identity/music/authorization/|
| 请求参数类型 |advertiser_id: number <br>item_id: number |advertiser_id: string <br>item_id: string |
|返回参数名称 |list<br>song_id|music_authorization<br>music_id|
| 返回参数类型 |item_id: number |item_id`: string |
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/identity/music/authorization/
**方法** GET
**Header**
```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
| advertiser_id {必填} | string |广告主ID。|
| item_id {必填} | string | TikTok 帖子 ID。 |
| identity_id{必填} | string | 认证身份ID。|
| identity_type{必填} | string | 认证身份类型。枚举值：`CUSTOMIZED_USER`, `AUTH_CODE`, `TT_USER`, `BC_AUTH_TT`。如果不传入，则返回所有结果。获取更多相关信息，请访问[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。 |
| identity_authorized_bc_id {+条件必填}| string |与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的ID。当`identity_type`为`BC_AUTH_TT`时必填。|
| locations{必填} | string[] |定向地区列表。必须使用与您创建广告时相同的地区列表。|
| start_time {必填} | string | 广告投放开始时间 (UTC), 格式为 "YYYY-MM-DD HH:MM:SS"。|
| end_time {必填}| string | 广告投放结束时间(UTC), 格式为 "YYYY-MM-DD HH:MM:SS"|
示例
(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "advertiser_id=ADVERTISER_ID" \
--data-urlencode "item_id=ITEM_ID" \
--data-urlencode "identity_id=IDENTITY_ID" \
--data-urlencode "identity_type=IDENTITY_TYPE" \
--data-urlencode "identity_authorized_bc_id=IDENTITY_AUTHORIZED_BC_ID" \
--data-urlencode "locations=[\"LOCATIONS\"]" \
--data-urlencode "start_time=START_TIME" \
--data-urlencode "end_time=END_TIME" \
https://business-api.tiktok.com/open_api/v1.3/identity/music/authorization/
(/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|返回数据。|
#| music_authorization | object[] |TikTok视频的音乐版权信息。|
##| item_id | string | TikTok视频ID。|
##| music_status | string | TikTok帖子中所有音乐的聚合授权状态。枚举值：`WITHOUT_SONG_ID`, `AUTHORIZATION_MISSING`, `WITH_FULL_AUTHORIZATION`。|
##| authorization_infos | object[] |音乐的授权信息。|
###| music_id | string |歌曲ID。|
###| author | string |歌手。|
###| title | string |歌曲名称。 |
###| labels | string[] |歌曲标签。|
###| lyricist | string |音乐作词者。|
###| composer | string | 音乐作曲者。|
###| publisher | string | 音乐发行商。|
###| authorization_type | string |授权类型。枚举值：`NOT_AUTHORIZED`, `AUTHORIZED`。|
|request_id |string|请求的日志ID，唯一标识一个请求。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "202208101819310102510031480D2B9AA4",
"data": {
"music_authorization": [
{
"music_status": MUSIC_STATUS,
"item": "VIDEO_ID",
"authorization_infos": [
{
"title": "TITLE",
"composer":" COMPOSER",
"author": "AUTHOR,
"publisher": PUBLISHER,
"lyricist": "LYRICIST",
"labels": ["LABELS"],
"authorization_type": "AUTHORIZED",
"music_id": "MUSIC_ID"
}
]
}
]
}
}
(/code)