Mud Tools

Appearance

会议数据查询 - 用户令牌 ​

IFeishuUserV1VideoConferencingMeetinData

功能描述 ​

用于分页查询当前用户相关的会议数据，包括查询会议明细、参会人明细、参会人会议质量数据以及会议室预定数据。使用用户令牌认证，仅能访问当前用户有权限的数据。

参考文档 ​

函数列表 ​

函数名称功能描述认证方式HTTP 方法
GetMeetingPageListAsync分页查询会议明细用户令牌GET
GetParticipantPageListAsync分页查询参会人明细用户令牌GET
GetParticipantQualityPageListAsync分页查询参会人会议质量数据用户令牌GET
GetResourceReservationPageListAsync分页查询会议室预定数据用户令牌GET

函数详细内容 ​

GetMeetingPageListAsync ​

根据时间范围分页查询会议明细，支持按用户、会议室、会议类型等条件筛选。

函数签名

csharp
Task<FeishuApiResult<GetMeetingListResult>?> GetMeetingPageListAsync(
    string start_time,
    string end_time,
    int? meeting_status = null,
    string? meeting_no = null,
    string? user_id = null,
    string? room_id = null,
    int? meeting_type = null,
    bool? include_external_meetings = null,
    bool? include_webinar = null,
    int? page_size = 20,
    string? page_token = null,
    string? user_id_type = "open_id",
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名类型必填描述示例
start_timestring✅查询开始时间（unix时间，单位sec）1608888867
end_timestring✅查询结束时间（unix时间，单位sec）1608888867
meeting_statusint?⚪会议状态：1=进行中，2=已结束，3=待召开（只读）2
meeting_nostring⚪9位会议号（会议链接最后9位数）123456789
user_idstring⚪按参会飞书用户筛选ou_3ec3f6a28a0d08c45d895276e8e5e19b
room_idstring⚪按参会Rooms筛选omm_eada1d61a550955240c28757e7dec3af
meeting_typeint?⚪按会议类型筛选：1=全部类型，2=视频会议，3=本地投屏2
include_external_meetingsbool?⚪是否查询外部会议false
include_webinarbool?⚪是否查询网络研讨会false
page_sizeint?⚪分页大小，最大条目数20
page_tokenstring⚪分页标记，首次查询不填-
user_id_typestring⚪用户 ID 类型：open_id / union_id / user_idopen_id
cancellationTokenCancellationToken⚪取消操作令牌对象default

说明

  • user_id、room_id 和 meeting_type 最多只能设置一个筛选条件，设置多个会导致参数校验失败

响应

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "meeting_list": [],
    "page_token": "",
    "has_more": false
  }
}

代码示例

csharp
var result = await api.GetMeetingPageListAsync(
    start_time: "1608888867",
    end_time: "1608889000",
    meeting_status: 2,
    page_size: 20
);
Console.WriteLine($"会议数量: {result?.Data?.MeetingList?.Count}");

GetParticipantPageListAsync ​

根据会议号和时间范围分页查询参会人明细。

函数签名

csharp
Task<FeishuApiResult<GetParticipantListResult>?> GetParticipantPageListAsync(
    string meeting_start_time,
    string meeting_end_time,
    string meeting_no,
    int? meeting_status = null,
    string? user_id = null,
    string? room_id = null,
    string? webinar_user_role = null,
    int? page_size = 20,
    string? page_token = null,
    string? user_id_type = "open_id",
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名类型必填描述示例
meeting_start_timestring✅会议开始时间（unix时间，单位sec）1655276858
meeting_end_timestring✅会议结束时间（unix时间，单位sec，进行中会议填当前时间）1655276858
meeting_nostring✅9位会议号（会议链接最后9位数）123456789
meeting_statusint?⚪会议状态：1=进行中，2=已结束，3=待召开2
user_idstring⚪按参会飞书用户筛选ou_3ec3f6a28a0d08c45d895276e8e5e19b
room_idstring⚪按参会Rooms筛选omm_eada1d61a550955240c28757e7dec3af
webinar_user_rolestring⚪网络研讨会观众类型：0=嘉宾，3=观众0
page_sizeint?⚪分页大小，最大条目数20
page_tokenstring⚪分页标记，首次查询不填-
user_id_typestring⚪用户 ID 类型：open_id / union_id / user_idopen_id
cancellationTokenCancellationToken⚪取消操作令牌对象default

说明

  • user_id 和 room_id 最多只能设置一个筛选条件

响应

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "participant_list": [],
    "page_token": "",
    "has_more": false
  }
}

代码示例

csharp
var result = await api.GetParticipantPageListAsync(
    meeting_start_time: "1655276858",
    meeting_end_time: "1655276900",
    meeting_no: "123456789",
    page_size: 20
);
Console.WriteLine($"参会人数: {result?.Data?.ParticipantList?.Count}");

GetParticipantQualityPageListAsync ​

查询参会人会议质量数据（仅支持已结束会议），返回音视频及共享质量数据。

函数签名

csharp
Task<FeishuApiResult<GetParticipantQualityListResult>?> GetParticipantQualityPageListAsync(
    string meeting_start_time,
    string meeting_end_time,
    string meeting_no,
    string join_time,
    string? user_id = null,
    string? room_id = null,
    int? page_size = 20,
    string? page_token = null,
    string? user_id_type = "open_id",
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名类型必填描述示例
meeting_start_timestring✅会议开始时间（unix时间，单位sec）1655276858
meeting_end_timestring✅会议结束时间（unix时间，单位sec）1655276858
meeting_nostring✅9位会议号123456789
join_timestring✅参会人入会时间（unix时间，单位sec），可从查询参会人明细接口获取1655276858
user_idstring⚪按参会飞书用户筛选ou_3ec3f6a28a0d08c45d895276e8e5e19b
room_idstring⚪按参会Rooms筛选omm_eada1d61a550955240c28757e7dec3af
page_sizeint?⚪分页大小，最大条目数20
page_tokenstring⚪分页标记，首次查询不填-
user_id_typestring⚪用户 ID 类型：open_id / union_id / user_idopen_id
cancellationTokenCancellationToken⚪取消操作令牌对象default

说明

  • 仅支持查询已结束会议的参会人质量数据

响应

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "participant_quality_list": [],
    "page_token": "",
    "has_more": false
  }
}

代码示例

csharp
var result = await api.GetParticipantQualityPageListAsync(
    meeting_start_time: "1655276858",
    meeting_end_time: "1655276900",
    meeting_no: "123456789",
    join_time: "1655276860",
    page_size: 20
);
Console.WriteLine($"质量数据条数: {result?.Data?.ParticipantQualityList?.Count}");

GetResourceReservationPageListAsync ​

分页查询会议室预定数据，支持按层级和会议室ID筛选。

函数签名

csharp
Task<FeishuApiResult<GetResourceReservationListResult>?> GetResourceReservationPageListAsync(
    string room_level_id,
    string start_time,
    string end_time,
    string[] room_ids,
    bool? need_topic = null,
    bool? is_exclude = null,
    int? page_size = 20,
    string? page_token = null,
    string? user_id_type = "open_id",
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名类型必填描述示例
room_level_idstring✅层级ID，非omb前缀的异常ID时默认使用租户层级兜底omb_57c9cc7d9a81e27e54c8fabfd02759e7
start_timestring✅查询开始时间（unix时间，单位sec）1655276858
end_timestring✅查询结束时间（unix时间，单位sec）1655276858
room_idsstring[]✅待筛选的会议室ID列表["omm_12443435556"]
need_topicbool?⚪是否展示会议主题true
is_excludebool?⚪true时排除room_ids列表中的会议室，获取剩余会议室预定数据false
page_sizeint?⚪分页大小，最大条目数20
page_tokenstring⚪分页标记，首次查询不填-
user_id_typestring⚪用户 ID 类型：open_id / union_id / user_idopen_id
cancellationTokenCancellationToken⚪取消操作令牌对象default

响应

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "resource_reservation_list": [],
    "page_token": "",
    "has_more": false
  }
}

代码示例

csharp
var result = await api.GetResourceReservationPageListAsync(
    room_level_id: "omb_57c9cc7d9a81e27e54c8fabfd02759e7",
    start_time: "1655276858",
    end_time: "1655363258",
    room_ids: new[] { "omm_12443435556" },
    page_size: 20
);
Console.WriteLine($"预定数据条数: {result?.Data?.ResourceReservationList?.Count}");