文档

GetLiveRoomUserStatistics - 分页查询直播用户数据统计

更新时间:

调用GetLiveRoomUserStatistics分页查询与指定直播相关的用户观看数据。后续计划迁入新方案,不推荐使用。

接口说明

观众的直播观看时长是用户观看时长的累加(包括多次观看,多设备观看),如果最终计算结果大于直播总时长,会按照直播总时长记录。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
AppIdstring

用户的应用ID,在控制台创建应用时生成。包含小写字母、数字,长度为6个字符。

7m***q
LiveIdstring

直播资源的唯一标识ID。

b7f2****ebb3
PageNumberstring

查询页码,从1开始,参数为空默认查询第1页。

1
PageSizestring

每页显示个数,最大支持50,参数为空默认显示个数为10。

25

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求ID。

FE22D613-D3C6-4A58-87CA-F21FC85AA08E
Resultobject

分页查询直播用户数据统计的结果。

LiveIdstring

直播资源的唯一标识ID。

b7f2****ebb3
TotalCountinteger

观看用户总数。

100
PageTotalinteger

观看用户总页数。

10
HasMoreboolean

是否还有下一页。

true
UserStatisticsListarray

用户观看数据列表。

object
UserIdstring

用户ID。

User001
WatchLiveTimeLong

观看时长,单位:毫秒。

100000
CommentCountinteger

该用户发送的弹幕消息数量。

100
LikeCountinteger

该用户的点赞数量。

100

示例

请求示例

http(s)://[Endpoint]/?Action=GetLiveRoomUserStatistics
&AppId=7m***q
&LiveId=b7f2****ebb3
&PageNumber=1
&PageSize=25
&公共请求参数

正常返回示例

JSON格式

{
    "RequestId": "FE22D613-D3C6-4A58-87CA-F21FC85AA08E",
    "Result": {
        "LiveId": "b7f2****ebb3",
        "TotalCount": 100,
        "PageTotal": 10,
        "HasMore": true,
        "UserStatisticsList": [
            {
                "UserId": "User001",
                "WatchLiveTime": 100000,
                "CommentCount": 100,
                "LikeCount": 100
            }
        ]
    }
}

XML格式

<GetLiveRoomUserStatisticsResponse>
    <RequestId>FE22D613-D3C6-4A58-87CA-F21FC85AA08E</RequestId>
    <Result>
        <LiveId>b7f2****ebb3</LiveId>
        <TotalCount>100</TotalCount>
        <PageTotal>10</PageTotal>
        <HasMore>true</HasMore>
        <UserStatisticsList>
            <UserId>User001</UserId>
            <WatchLiveTime>100000</WatchLiveTime>
            <CommentCount>100</CommentCount>
            <LikeCount>100</LikeCount>
        </UserStatisticsList>
    </Result>
</GetLiveRoomUserStatisticsResponse>

错误码

访问错误中心查看更多错误码。