获取视频维度下按天统计的地理位置播放时长

更新时间：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": []
            },
          ...
        ]
    }
}

results matching ""

    No results matching ""