根据用户所给参数,搜索符合条件的媒资。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
MediaIds | string | 否 | IMS媒资ID。
| ****20b48fb04483915d4f2cd8ac****,****15d4a4b0448391508f2cb486**** |
DynamicMetaDataMatchFields | string | 否 | 动态元数据搜索匹配条件 | "ApprovalStatus='Available'&MaterialBags='boutiquemusic'&Mood='Nervous'" |
Favorite | boolean | 否 | 用户是否收藏了该媒资。 | true |
Authorized | boolean | 否 | 用户是否已购买了包含此媒资的资源包。 | true |
SortBy | string | 否 | 结果排序方式 field:
order:
| UsageCount:Desc,UnitPrice:Asc |
PageNo | integer | 否 | 页号 | 1 |
PageSize | integer | 否 | 每页行数大小。 | 10 |
EntityId | string | 否 | 实体ID,用来标识不同种类的公共版权媒资。取值:
| Copyright_Music |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "****3CFB-2767-54FD-B311-BD15A4C1****",
"TotalCount": 100,
"PublicMediaInfos": [
{
"Authorized": true,
"Favorite": true,
"RemainingAuthTime": "100",
"MediaInfo": {
"MediaId": "icepublic-****87b921bb4a55908a72a0537e****",
"MediaBasicInfo": {
"MediaId": "icepublic-****87b921bb4a55908a72a0537e****",
"MediaType": "audio",
"BusinessType": "general",
"Source": "oss",
"Title": "title",
"Description": "description",
"Category": "category",
"MediaTags": "标签,tag1",
"CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=<ExpireTime>&OSSAccessKeyId=<OSSAccessKeyId>&Signature=<Signature>&security-token=<SecurityToken>",
"UserData": "userDataTest",
"Status": "Normal",
"CreateTime": "2020-12-26T06:04:49Z",
"ModifiedTime": "2020-12-26T06:04:50Z",
"DeletedTime": "2020-12-29T06:04:49Z",
"SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]"
},
"DynamicMetaData": {
"Data": "\"{\\\"AuditionUrl\\\": \\\"http://xxx\\\", \\\"AuditionCount\\\": 3...}\"",
"Type": "system"
}
}
}
]
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2021-11-25 | 新增 OpenAPI | 看变更集 |