获取视频维度下按天统计的地理位置播放时长
更新时间:2020-9-30
1. v2版本
接口描述
该接口用于获取视频维度下按天统计的地理位置播放时长,请求参数和v1相同,返回数据中play_duration包含字段和v1有所不同。
请求地址
https://spark.bokecc.com/api/stats/playduration/video/daily/location/v2
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
videoid |
String |
是 |
视频ID。 |
start_date |
String |
是 |
查询开始日期(含),格式:yyyy-MM-dd。 |
end_date |
String |
是 |
查询结束日期(含),日期不能大于今日,格式为yyyy-MM-dd。 注:end_date与start_date之间的差值最多为30。 |
请求示例
https://spark.bokecc.com/api/stats/playduration/video/daily/location/v2?end_date=2016-10-19&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1671610865286&userid=CC443A6686737xxx&hash=E7C7CFC1C713261EC97053F1153A3B4E&start_date=2016-10-18
返回数据
名称 |
类型 |
说明 |
play_durations |
Object |
地理位置播放时长。 |
play_durations说明
名称 |
类型 |
说明 |
play_duration |
Array |
地理位置播放时长信息。 |
play_duration说明
名称 |
类型 |
说明 |
province |
String |
省级地区名称,中文。 |
flash |
Integer |
对应省级地区的Flash端播放时长,单位:秒。 |
pc_h5 |
Integer |
对应省级地区的PC-h5端播放时长,单位:秒。 |
android |
Integer |
对应省级地区的h5-移动端播放时长,单位:秒。 |
ios |
Integer |
对应省级地区的h5-移动端播放时长,单位:秒。 |
mobile_h5 |
Integer |
对应省级地区的h5-移动端播放时长,单位:秒。 |
cities |
Array |
省级地区下辖城市数据列表节点。 |
cities说明
名称 |
类型 |
说明 |
city |
String |
市级地区名称,中文。 |
flash |
Integer |
对应省级地区的Flash端播放时长,单位:秒。 |
pc_h5 |
Integer |
对应省级地区的PC-h5端播放时长,单位:秒。 |
android |
Integer |
对应省级地区的h5-移动端播放时长,单位:秒。 |
ios |
Integer |
对应省级地区的h5-移动端播放时长,单位:秒。 |
mobile_h5 |
Integer |
对应省级地区的h5-移动端播放时长,单位:秒。 |
返回示例
{
"play_durations": {
"play_duration": [
{
"province": "河北省",
"flash": 10000,
"pc_h5": 10000,
"android": 10000,
"ios": 10000,
"mobile_h5": 7000,
"cities": [
{
"city": "沧州",
"flash": 10000,
"pc_h5": 10000,
"android": 10000,
"ios": 10000,
"mobile_h5": 7000
},
...
]
},
{
"province": "台湾省",
"flash": 10000,
"pc_h5": 10000,
"android": 10000,
"ios": 10000,
"mobile_h5": 7000,
"cities": []
},
...
]
}
}
2. v1版本
接口描述
该接口用于获取视频维度下按天统计的地理位置播放时长。
请求地址
https://spark.bokecc.com/api/stats/playduration/video/daily/location
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
videoid |
String |
是 |
视频ID。 |
start_date |
String |
是 |
查询开始日期(含),格式:yyyy-MM-dd。 |
end_date |
String |
是 |
查询结束日期(含),日期不能大于今日,格式为yyyy-MM-dd。 注:end_date与start_date之间的差值最多为30。 |
请求示例
https://spark.bokecc.com/api/stats/playduration/video/daily/location?end_date=2016-10-19&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1671610865286&userid=CC443A6686737xxx&hash=E7C7CFC1C713261EC97053F1153A3B4E&start_date=2016-10-18
返回数据
名称 |
类型 |
说明 |
play_durations |
Object |
地理位置播放时长。 |
play_durations说明
名称 |
类型 |
说明 |
play_duration |
Array |
地理位置播放时长信息。 |
play_duration说明
名称 |
类型 |
说明 |
province |
String |
省级地区名称,中文。 |
pc |
Integer |
对应省级地区的PC端播放时长。 |
mobile |
Integer |
对应省级地区的移动端播放时长。 |
cities |
Array |
省级地区下辖城市数据列表节点。 |
cities说明
名称 |
类型 |
说明 |
city |
String |
市级地区名称,中文。 |
pc |
Integer |
对应市级地区的PC端播放时长。 |
mobile |
Integer |
对应市级地区的移动端播放时长。 |
返回示例
{
"play_durations": {
"play_duration": [
{
"province": "河北省",
"pc": 100000,
"mobile": 50000,
"cities": [
{
"city": "沧州",
"pc": 10000,
"mobile": 3000
},
...
]
},
{
"province": "台湾省",
"pc": 30000,
"mobile": 2000,
"cities": []
},
...
]
}
}