获取操作日志报告

操作日志报告允许您审核管理员和用户活动，例如添加新用户，更改帐户设置和删除录音。

使用此API检索指定时间段内的操作日志报告。

** 先决条件: **

Pro或更高的计划。

** 范围: ** '报告: master'

** [速率限制标签](https://marketplace.zoom.us/docs/api参考/速率限制 # 速率限制):** “沉重”

请求参数

Path 参数

accountId

string

帐户的唯一标识符。

必需

Query 参数

from

string

必需

以 'yyyy-mm-d' 格式的开始日期。“从” 和 “到” 参数定义的日期范围应该只有一个月，因为报告一次只包括一个月的数据。

string

结束日期。

必需

page_size

integer

可选

单个API调用中返回的记录数。

next_page_token

string

可选

使用next page标记对大型结果集进行分页。只要可用结果集超过当前页面大小时，就会返回下一页令牌。此令牌的有效期为15分钟。

category_type

string

可选

** 可选 **

按类别类型过滤您的响应，以查看特定类别的报告。
此字段的值可以是以下值之一:
“所有”
'用户'
'user_settings'
“帐户”
'计费'
'im'
'记录'
'phone_contacts'
'网络研讨会'
'sub_account'
'role'
'zoom_rooms'

返回响应

🟢200** HTTP状态代码: ** '200' 返回操作日志报告

application/json

Body

分页对象。

next_page_token

string

可选

下一页标记用于通过大型结果集进行分页。每当可用结果列表的集合超过页面大小时，将返回下一页令牌。过期时间为15分钟。

示例值:

uBTK3NzNksdkuCUAQaFVFd86kyOr59zg4U2

operation_logs

array [object {5}]

操作日志对象数组

可选

operation_detail

string

操作详细信息

可选

示例值:

delete user - user2@example.com

action

string

行动

可选

示例值:

delete

category_type

string

类别类型

可选

示例值:

user

time

string <date-time>

执行操作的时间。

可选

示例值:

2022-01-25T17:52:16Z

operator

string

执行操作的用户。

可选

示例值:

admin@example.com

page_size

integer

可选

单个API调用中返回的记录数。

<= 300

默认值:

示例值:

示例

{
    "next_page_token": "uBTK3NzNksdkuCUAQaFVFd86kyOr59zg4U2",
    "operation_logs": [
        {
            "operation_detail": "delete user - user2@example.com",
            "action": "delete",
            "category_type": "user",
            "time": "2022-01-25T17:52:16Z",
            "operator": "admin@example.com"
        }
    ],
    "page_size": 30
}

🟠400** HTTP状态代码: ** '400' <br> 错误的请求 ** 错误代码: ** '200' <br> 没有权限。<br>

请求参数

示例代码

返回响应