调用GetLiveRoomUserStatistics分页查询与指定直播相关的用户观看数据。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GetLiveRoomUserStatistics

系统规定参数。取值:GetLiveRoomUserStatistics

AppId String 7m***q

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

LiveId String b7f2****ebb3

直播资源的唯一标识ID。

PageNumber String 1

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

PageSize String 25

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

返回数据

名称 类型 示例值 描述
RequestId String FE22D613-D3C6-4A58-87CA-F21FC85AA08E

请求ID。

Result Object

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

LiveId String b7f2****ebb3

直播资源的唯一标识ID。

TotalCount Integer 100

观看用户总数。

PageTotal Integer 10

观看用户总页数。

HasMore Boolean true

是否还有下一页。

UserStatisticsList Array of UserStatisticsList

用户观看数据列表。

UserId String User001

用户ID。

WatchLiveTime Long 100000

观看时长,单位:毫秒。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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>
        </UserStatisticsList>
    </Result>
</GetLiveRoomUserStatisticsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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