列出所有录音

GET

/accounts/{accountId}/users/{userId}/recordings

列出用户的所有云录音。

对于用户级应用，传递 ['me' 值](https://developers.zoom.us/docs/api/rest/using-zood-api/# the-me-关键字) 而不是 'userId' 参数。

要访问用户的受密码保护的云记录，请将用户的 OAuth访问令牌作为授权标头中的承载令牌发送。

示例: 'curl -H "授权: Bearer <ACCESS_TOKEN>" https://{{base-domain}}/rec/archive/download/xyz'

** 先决条件: **

必须有一个专业或更高的计划。
必须在用户帐户上启用云记录。

** 范围: ** '录音: master'

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

请求参数

Path 参数

userId

string

必需

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

accountId

string

帐户的唯一标识符。

必需

Query 参数

page_size

integer

可选

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

next_page_token

string

可选

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

string

可选

如果为会议使用本地会议连接器，则查询录制的元数据。

trash

string

可选

查询垃圾箱。

“真”-从垃圾桶列表录音。

'false'-不从垃圾桶中列出录音。

默认值为 “false”。如果将其设置为 “true”，则可以使用 “trash_type” 属性来指示需要检索的云记录的类型。

from

string

可选

您要检索录音的日期范围的 “yyyy-mm-dd-' UTC格式的开始日期。最大范围可以是一个月。如果没有为此字段提供值，则默认值为当前日期。例如，如果您在2020年6月30日发出API请求，但未提供 “从” 和 “到” 参数，默认情况下，“从” 字段的值将为 “2020-06-30”，“到” 字段的值将为 “2020-07-01”。

** 注意 **: “垃圾” 文件不能按日期范围过滤，因此，“从” 和 “到” 字段不应用于垃圾文件。

string

可选

结束日期，格式为 “yyyy-mm-d'” “yyyy-mm-d' UTC”。

trash_type

string

可选

要从垃圾箱中检索的云记录的类型。

'meeting_recordings': 从垃圾箱中列出所有会议记录。

'recording_file': 从废纸篓中列出所有单独的录音文件。

meeting_id

integer

会议ID。

可选

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

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

application/json

Body

分页对象。

next_page_token

string

可选

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

示例值:

Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3

total_records

integer

可选

跨页可用的所有记录数。

示例值:

from

string <date>

开始日期。

可选

示例值:

2022-01-01

meetings

array [object {12}]

记录列表。

可选

duration

integer

会议持续时间。

可选

示例值:

start_time

string <date-time>

会议开始的时间。

可选

示例值:

2021-03-18T05:41:36Z

account_id

string

可选

用户帐户的唯一标识符。

示例值:

Cx3wERazSgup7ZWRHQM8-w

recording_play_passcode

string

可选

要在URL中使用的云录制的密码。这个录音的密码可以直接拼接在 'play_url' 或 'share_url' 与 '？pwd =' 访问和播放。例如，“https:// zoom.us/rec/share/*************？pwd = yNYIS408EJygs7rE5vVsJwXIz4-VW7MH”。如果要使用此字段，请与Zoom支持人员联系。

示例值:

yNYIS408EJygs7rE5vVsJwXIz4-VW7MH

recording_files

array [object {13}]

录制文件的列表。

可选

total_size

integer <int64>

可选

记录的总文件大小。这包括 'recording_files' 和 'participant_audio_files' 文件。

示例值:

recording_count

integer

可选

此API调用的响应中返回的录制文件数。这包括 'recording_files' 和 'participant_audio_files' 文件。

示例值:

topic

string

会议主题。

可选

示例值:

My Personal Meeting

integer

可选

会议ID-也称为会议编号。

示例值:

6840331990

type

enum<string>

可选

录音的关联会议或网络研讨会类型:

如果录音是会议的:

'1'-即时会议。

'2'-预定的会议。

'3'-没有固定时间的定期会议。

'4'-通过PMI (个人会议ID) 创建的会议。

'7' - A 个人音频会议 (PAC)。

'8'-固定时间的定期会议。

如果录制的是网络研讨会:

'5'-网络研讨会。

'6'-没有固定时间的经常性网络研讨会

'9'-固定时间的定期网络研讨会。

如果录音 ** 不是 ** 来自会议或网络研讨会:

'99'-通过Zoom门户网站上的 ** 记录 ** 界面上传的记录。

枚举值:

12345678999

示例值:

uuid

string

可选

唯一会议标识符。会议的每个实例都有自己的UUID。

示例值:

BOKXuumlTAGXuqwr3bLyuQ==

host_id

string

可选

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

示例值:

_0ctZtY0REqWalTmwvrdIw

string <date>

结束日期。

可选

示例值:

2022-04-01

page_count

integer

可选

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

示例值:

page_size

integer

可选

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

<= 300

默认值:

示例值:

示例

{
    "next_page_token": "Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3",
    "total_records": 1,
    "from": "2022-01-01",
    "meetings": [
        {
            "duration": 20,
            "start_time": "2021-03-18T05:41:36Z",
            "account_id": "Cx3wERazSgup7ZWRHQM8-w",
            "recording_play_passcode": "yNYIS408EJygs7rE5vVsJwXIz4-VW7MH",
            "recording_files": [
                {
                    "file_path": "/9090876528/path01/demo.mp4",
                    "play_url": "https://example.com/rec/play/Qg75t7xZBtEbAkjdlgbfdngBBBB",
                    "meeting_id": "L0AGOEPVR9m5WSOOs/d+FQ==",
                    "file_size": 7220,
                    "recording_end": "2021-03-18T05:41:36Z",
                    "file_type": "MP4",
                    "recording_type": "shared_screen_with_speaker_view(CC)",
                    "download_url": "https://example.com/rec/download/Qg75t7xZBtEbAkjdlgbfdngBBBB",
                    "file_extension": "MP4",
                    "id": "72576a1f-4e66-4a77-87c4-f13f9808bd76",
                    "deleted_time": "2021-03-18T05:41:36Z",
                    "recording_start": "2021-03-18T05:41:36Z",
                    "status": "completed"
                }
            ],
            "total_size": 22,
            "recording_count": 22,
            "topic": "My Personal Meeting",
            "id": 6840331990,
            "type": "1",
            "uuid": "BOKXuumlTAGXuqwr3bLyuQ==",
            "host_id": "_0ctZtY0REqWalTmwvrdIw"
        }
    ],
    "to": "2022-04-01",
    "page_count": 1,
    "page_size": 30
}

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

修改于 2023-10-31 06:13:33

获取会议录制设置

删除会议录制文件