列出会议

列出会议主持人用户已安排的会议。对于用户级应用，传递 ['me' 值](https://developers.zoom.us/docs/api/rest/using-zoom-api/# the-me-关键字) 而不是 'userId' 参数。

** 注 **

此API ** 仅 ** 支持预定的会议。此API不返回有关即时会议的信息。

此API仅返回用户的 [未过期会议](https://support.zoom.us/hc/en-us/articles/201362373-会议ID # h_c73f9b08-c1c0-4a1a-b538-e01ebb98e844)。

** 范围: ** 'meeting:master'

** [速率限制标签](https://marketplace.zoom.us/docs/api-reference/Rate-limits # 速率限制):** 'MEDIUM'

请求参数

Path 参数

userId

string

必需

用户的用户ID或电子邮件地址。对于用户级应用，传递 “我” 值。

accountId

string

帐户的唯一标识符。

必需

Query 参数

type

string

可选

会议的类型。

'scheduled'-所有有效的先前 (未过期) 会议，现场会议和即将举行的预定会议。

'live'-所有正在进行的会议。

'upcoming'-所有即将举行的会议，包括现场会议。

'upcoming_meetings'-所有即将举行的会议，包括实时会议。

'previous_meetings'-所有以前的会议。

page_size

integer

可选

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

next_page_token

string

可选

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

page_number

integer

可选

返回记录中当前页面的页码。

from

string

开始日期。

可选

string

结束数据。

可选

返回响应

🟢200** HTTP状态代码: ** '200' 返回的会议对象列表。

application/json

Body

分页对象。

page_number

integer

当前结果的页码。

可选

默认值:

示例值:

next_page_token

string

可选

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

示例值:

Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3

total_records

integer

可选

跨页可用的所有记录的总数。

示例值:

meetings

array [object {12}]

会议对象列表。

可选

duration

integer

会议持续时间。

可选

示例值:

start_time

string <date-time>

会议开始时间。

可选

示例值:

2022-03-23T06:00:00Z

join_url

string

可选

参与者可以加入会议的URL。

示例值:

https://example.com/j/11111

timezone

string

可选

设置会议开始时间格式的时区。

示例值:

America/Los_Angeles

created_at

string <date-time>

创造的时间。

可选

示例值:

2022-03-23T05:31:16Z

topic

string

会议主题。

可选

示例值:

My Meeting

integer <int64>

可选

会议ID-也称为长 (int64) 格式的会议编号。

示例值:

97763643886

type

enum<integer>

可选

会议类型:
'1'-即时会议。
'2'-预定的会议。
“3”-没有固定时间的定期会议。
“8”-固定时间的定期会议。

枚举值:

1238

示例值:

agenda

string

可选

会议描述。列出用户的所有会议时，议程的长度被截断为250个字符。要查看会议的完整议程，请检索单个会议的详细信息，使用 [** Get a meeting **](/docs/api-reference/zoom-api/methdos # operation/meeting) 接口。

示例值:

My Meeting

pmi

string

可选

[个人会议ID](https://developers.zoom.us/docs/api/rest/使用-zoop-api/# 了解-个人-会议-id-pmi)。仅当使用PMI安排会议时才返回此字段。

示例值:

97891943927

uuid

string

可选

唯一的会议ID。每个会议实例将生成自己的会议UUID。

示例值:

aDYlohsHRtCd4ii1uC2+hA==

host_id

string

可选

设置为会议主持人的用户的ID。

示例值:

30R7kT7bTIKSNUFEuH_Qlg

page_count

integer

可选

为发出的请求返回的页数。

示例值:

page_size

integer

可选

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

<= 300

默认值:

示例值:

示例

{
    "page_number": 1,
    "next_page_token": "Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3",
    "total_records": 1,
    "meetings": [
        {
            "duration": 60,
            "start_time": "2022-03-23T06:00:00Z",
            "join_url": "https://example.com/j/11111",
            "timezone": "America/Los_Angeles",
            "created_at": "2022-03-23T05:31:16Z",
            "topic": "My Meeting",
            "id": 97763643886,
            "type": 1,
            "agenda": "My Meeting",
            "pmi": "97891943927",
            "uuid": "aDYlohsHRtCd4ii1uC2+hA==",
            "host_id": "30R7kT7bTIKSNUFEuH_Qlg"
        }
    ],
    "page_count": 1,
    "page_size": 30
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '3161' 您的用户帐户不允许使用会议托管和日程安排功能。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '1001' 用户 {userId} 不存在或不属于此帐户。

请求参数

示例代码

返回响应