实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频实时音视频服务端 API 参考历史数据查询获取离线运营分布数据 ListOperationDistribution
复制全文
下载 pdf获取离线运营分布数据 ListOperationDistribution
文档反馈
问问助手查询指定应用在特定时间段内，按地理维度（如省份、国家）划分的离线运营数据。目前仅支持查询通话人数。
注意事项
- 最大请求次数：2 次/秒
- 可查询时间范围：最近 30 天
- 单次查询时间范围：不超过 7 天
- 数据延迟：8 小时
请求说明
- 请求方式：POST
- 请求地址：https://rtc.volcengineapi.com?Action=ListOperationDistribution&Version=2023-11-01
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Query
Action String 必选 示例值：ListOperationDistribution
接口名称。当前 API 的名称为 ListOperationDistribution。
Version String 必选 示例值：2023-11-01
接口版本。当前 API 的版本为 2023-11-01。
Body
AppId String 必选 示例值：66****3cf
StartTime String 必选 示例值：2021-07-24T00:00:00+08:00
查询起始时间戳，格式为 RFC3339，单位为秒。
EndTime String 必选 示例值：2021-07-26T00:00:00+08:00
查询结束时间戳，格式为 RFC3339，单位为秒。
Indicator String 必选 示例值：user_count
查询的指标名称。
目前仅支持查询 user_count，即此 AppId 在所选日期的通话总人数。通话人数按用户 id 去重。
Dimension String 必选 示例值：province
查询的维度，一次仅支持查询一个维度。支持取值及含义如下：
- Province：一级行政区（包括港澳台地区）
- Country：国家
返回参数
Name String 示例值：user_num
指标名称。
Dimension String 示例值：province
查询维度。
Data Object[] 示例值：-
具体的指标值以及对应时间。
Value Double 示例值：666.00
指标值。
Proportion Double 示例值：66.66
占比。
DistributionName String 示例值：上海
维度名。
请求示例
POST https://rtc.volcengineapi.com?Action=ListOperationDistribution&Version=2023-11-01
{
"AppId": "661e7ae5543cf",
"StartTime": "2021-07-24T00:00:00+08:00",
"EndTime": "2021-07-26T00:00:00+08:00",
"Indicator": "user_count",
"Dimension": "province"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20230604110420",
"Action": "ListOperationDistribution",
"Version": "2023-11-01",
"Service": "rtc",
"Region": "cn-north-1"
},
"Result": {
"Name": "user_num",
"Dimension": "province",
"Data": [
{
"DistributionName": "上海",
"Value": 666,
"Proportion": 66.66
},
{
"DistributionName": "北京",
"Value": 123,
"Proportion": 12.31
}
]
}
}
错误码
最近更新时间：2026.08.19 18:32:18
这个页面对您有帮助吗？
有用
有用
无用
无用