Skip to main content
POST
获取用户页面 Analytics

概览

获取 Teams 页面上显示的用户活动统计信息,包括用户名、emails、最近活动时间和活跃天数,以及使用的提示额度。

请求

string
必填
具有 “Teams Read-only” 权限的服务密钥
string
将结果筛选为特定组内的用户(可选)
string
开始时间,采用 RFC 3339 格式(例如:2023-01-01T00:00:00Z)。仅影响 activeDays 计算。 如果未提供,则默认为 1 年前。
string
结束时间,采用 RFC 3339 格式(例如:2023-12-31T23:59:59Z)。仅影响 activeDays 计算。 如果未提供,则默认为当前时间。

示例请求

响应

array
用户统计对象数组
string
当前计费周期开始时间,RFC 3339 格式。userTableStats 中的 promptCreditsUsed 数值对应于该计费周期内的使用量。
string
当前计费周期结束时间,RFC 3339 格式。userTableStats 中的 promptCreditsUsed 数值对应于该计费周期内的使用量。

示例响应

错误响应

string
描述问题原因的错误信息
常见错误情况:
  • 服务密钥无效或权限不足
  • 时间戳格式无效
  • 未找到分组
  • 触发速率限制