QueryActiveUserStatistic - 查询活跃用户统计

更新时间:
复制 MD 格式

查询指定时间范围内的活跃用户数统计趋势。按照指定的时间聚合粒度(Period),返回每个时间切片点上的去重活跃用户数,用于绘制在线用户趋势图。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

StartTime

string

查询起始时间。支持两种格式:

  • UTC 格式:yyyy-MM-ddTHH:mm:ssZ。

  • 普通格式:yyyy-MM-dd HH:mm:ss。

不能早于 6 个月前,不能晚于 EndTime。

2020-11-30T06:32:31Z

EndTime

string

查询截止时间。格式同 StartTime。若晚于当前时间则自动截断为当前时间。

2020-12-01T06:32:31Z

Period

string

统计数据的聚合粒度。取值:

  • ONE_MINUTE:1 分钟。

  • TWO_MINUTE:2 分钟。

  • FIVE_MINUTE(默认):5 分钟。

  • ONE_HOUR:1 小时。

  • ONE_DAY:1 天。

FIVE_MINUTE

BizType

integer

业务渠道类型码。取值:

  • 1(默认):企业版。

  • 3:云办公室。

  • 10:标准版。

  • 20:商业版。

  • 30:教育商业版。

  • 40:云手机隔离资源。

  • 50:AgentBay。

1

OfficeSiteId

string

工作区 ID。指定后仅统计该工作区下的桌面活跃用户。

cn-hangzhou+dir-885351****

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

1CBAFFAB-B697-4049-A9B1-67E1FC5F****

TotalCount

integer

数据点总数。

20

UserStatisticList

array<object>

活跃用户统计数据列表。

object

ActiveUserCount

integer

该统计周期内的去重活跃用户数。

56

FormatDate

string

格式化后的东八区日期字符串,格式为 yyyy-MM-dd。

2020-11-30

TimeStamp

integer

数据点对应的 epoch 毫秒级别戳。

1606723951000

示例

正常返回示例

JSON格式

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "TotalCount": 20,
  "UserStatisticList": [
    {
      "ActiveUserCount": 56,
      "FormatDate": "2020-11-30",
      "TimeStamp": 1606723951000
    }
  ]
}

错误码

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

变更历史

更多信息,参考变更详情