最近更新时间:2024.01.08 11:26:25
首次发布时间:2022.09.27 21:09:36
此接口用于查询指定视频的播放信息。
请求地址:https://vod.volcengineapi.com?Action=DescribeVodPlayedStatisData&Version=2020-08-01
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeVodPlayedStatisData | 接口名称。当前 API 的名称为 DescribeVodPlayedStatisData 。 |
Version | String | 是 | 2020-08-01 | 接口版本。当前 API 的版本为 2020-08-01 。 |
Space | String | 是 |
| 点播空间名称。您可通过以下方式获取空间名称: |
StartTime | String | 是 | 2023-12-23T16:00:00Z | 开始时间,RFC3339 格式。 |
EndTime | String | 是 |
| 结束时间,RFC3339 格式。 说明 最早查询 31 天内的数据。 |
VidList | Array of String | 是 |
| 查询的 Vid 列表,最大 100。 说明 如果 GET 请求,用英文逗号 |
OrderType | String | 否 |
| 排序类型。取值如下:
|
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Space | String | test | 点播空间名称。 |
StartTime | String | 2023-12-23T16:00:00Z | 开始时间,RFC3339 格式。 |
EndTime | String | 2023-12-24T15:59:59Z | 结束时间,RFC3339 格式。 |
VidList | Array of String | ["v03c24g10001c***v0vp0ml6d3","v02c24g10001***9s1v0ss463b","v02c24g10001***v0tk8qog730"] | 要查询的 vid 列表。 |
OrderType | String |
| 排序类型。取值如下:
|
PlayStatInfos | Array of PlayStatInfos | - | 播放信息。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Vid | String | v02c24g10001***v0tk8qog730 | 视频 ID。 |
Name | String | title | 视频名称。 |
Size | Integer | 121809370 | 视频大小,单位为字节。 |
Duration | Float | 158.583 | 视频长度,单位为秒。 |
CreateTime | String | 2023-12-25 14:19:20 | 视频创建时间。 |
PlayCount | Integer | 0 | 播放次数。 |
Traffic | Integer | 0 | 流量,单位为字节。 |
https://vod.volcengineapi.com?Action=DescribeVodPlayedStatisData&Version=2020-08-01&Space=&StartTime=&EndTime=&VidList=&OrderType= { "Space": "test", "StartTime": "2021-04-13T00:00:00Z", "EndTime": "2021-04-14T00:00:00Z", "VidList": [ "1232131", "1324324" ] }
{ "ResponseMetadata": { "RequestId": "202312251425***B0AAD021485A65C0", "Action": "DescribeVodPlayedStatisData", "Version": "2023-07-01", "Service": "vod", "Region": "cn-north-1" }, "Result": { "Space": "test", "StartTime": "2023-12-23T16:00:00Z", "EndTime": "2023-12-24T15:59:59Z", "VidList": [ "v03c24g10001c***v0vp0ml6d3", "v02c24g10001***9s1v0ss463b", "v02c24g10001***v0tk8qog730" ], "OrderType": "count_up", "PlayStatInfos": [ { "Vid": "v03c24g10001c***v0vp0ml6d3", "Name": "title", "Duration": 158.583, "Size": 121809370, "PlayCount": 0, "CreateTime": "2023-12-25 14:20:01", "Traffic": 0 }, { "Vid": "v02c24g10001***9s1v0ss463b", "Name": "title", "Duration": 158.583, "Size": 121809370, "PlayCount": 0, "CreateTime": "2023-12-25 14:19:40", "Traffic": 0 }, { "Vid": "v02c24g10001***v0tk8qog730", "Name": "title", "Duration": 158.583, "Size": 121809370, "PlayCount": 0, "CreateTime": "2023-12-25 14:19:20", "Traffic": 0 } ] } }
本接口无特有的错误码。更多信息请见公共错误码。