介绍
# Zoom
使用 `scripts/zoom.py` 与 Zoom 的 REST API 进行交互。
## 前置要求
```bash pip3 install requests PyJWT --break-system-packages ```
## 身份验证
在技能的 `.env` 文件中设置以下内容（从 `.env.example` 复制）：
- `ZOOM_ACCOUNT_ID` — 账户 ID（来自 Zoom Marketplace 应用） - `ZOOM_CLIENT_ID` — OAuth 客户端 ID - `ZOOM_CLIENT_SECRET` — OAuth 客户端密钥 - `ZOOM_USER_EMAIL` — 要以此身份操作的 Zoom 用户的电子邮件（S2S 应用需要；如果未设置，默认为 `me`） - `ZOOM_RTMS_CLIENT_ID` — RTMS Marketplace 应用的客户端 ID（`rtms-start`/`rtms-stop` 需要；这是一个与 S2S OAuth 应用分开的应用）
在 https://marketplace.zoom.us/ 创建一个 **Server-to-Server OAuth** 应用以获取完整的 API 访问权限。
有关详细的设置指南，请参阅 [references/AUTH.md](references/AUTH.md)。
## 命令
### 会议
```bash # List upcoming meetings python3 scripts/zoom.py meetings list
# List live/in-progress meetings (requires Business+ plan with Dashboard) python3 scripts/zoom.py meetings live
# Start RTMS for a live meeting (requires ZOOM_RTMS_CLIENT_ID) python3 scripts/zoom.py meetings rtms-start <meeting_id>
# Stop RTMS for a live meeting python3 scripts/zoom.py meetings rtms-stop <meeting_id>
# Get meeting details python3 scripts/zoom.py meetings get <meeting_id>
# Schedule a new meeting python3 scripts/zoom.py meetings create --topic "Standup" --start "2026-01-28T10:00:00" --duration 30
# Schedule with options python3 scripts/zoom.py meetings create --topic "Review" --start "2026-01-28T14:00:00" --duration 60 --agenda "Sprint review" --password "abc123"
# Delete a meeting python3 scripts/zoom.py meetings delete <meeting_id>
# Update a meeting python3 scripts/zoom.py meetings update <meeting_id> --topic "New Title" --start "2026-01-29T10:00:00" ```
### 日程（即将进行的安排）
```bash # Today's meetings python3 scripts/zoom.py meetings list --from today --to today
# This week's meetings python3 scripts/zoom.py meetings list --from today --days 7 ```
### 录像
```bash # List cloud recordings python3 scripts/zoom.py recordings list
# List recordings for date range python3 scripts/zoom.py recordings list --from "2026-01-01" --to "2026-01-31"
# Get recording details python3 scripts/zoom.py recordings get <meeting_id>
# Download recording files (video/audio) python3 scripts/zoom.py recordings download <meeting_id> python3 scripts/zoom.py recordings download <meeting_id> --output ~/Downloads
# Download transcript files only python3 scripts/zoom.py recordings download-transcript <meeting_id> python3 scripts/zoom.py recordings download-transcript <meeting_id> --output ~/Downloads
# Download AI Companion summary as markdown python3 scripts/zoom.py recordings download-summary <meeting_uuid> python3 scripts/zoom.py recordings download-summary <meeting_uuid> --output ~/Downloads
# Delete a recording python3 scripts/zoom.py recordings delete <meeting_id> ```
### AI 会议摘要（AI 同伴）
```bash # List meeting summaries python3 scripts/zoom.py summary list python3 scripts/zoom.py summary list --from "2026-01-01" --to "2026-01-31"
# Get AI summary for a specific meeting python3 scripts/zoom.py summary get <meeting_id> ```
### 用户
```bash # Get my profile python3 scripts/zoom.py users me
# List users (admin) python3 scripts/zoom.py users list ```
### 团队聊天
```bash # List chat channels python3 scripts/zoom.py chat channels
# List messages in a channel python3 scripts/zoom.py chat messages <channel_id>
# Send a message to a channel python3 scripts/zoom.py chat send <channel_id> "Hello team!"
# Send a direct message python3 scripts/zoom.py chat dm <email> "Hey, are you free?"
# List contacts python3 scripts/zoom.py chat contacts ```
### 电话
```bash # List call logs python3 scripts/zoom.py phone calls --from "2026-01-01" --to "2026-01-31" ```
## 所需范围
对于 Server-to-Server OAuth，请在您的 Zoom Marketplace 应用中启用这些范围。
只添加您需要的范围 — 每个命令组都需要特定的范围：
| 命令组 | 所需范围 | |---|---| | `users me` / `users list` | `user:read:admin` | | `meetings list/get/create/update/delete` | `meeting:read:admin`, `meeting:write:admin` | | `recordings list/get/delete` | `recording:read:admin`, `recording:write:admin` | | `chat channels/messages/send/dm` | `chat_channel:read:admin`, `chat_message:read:admin`, `chat_message:write:admin` | | `chat contacts` | `contact:read:admin` | | `summary list/get` | `meeting_summary:read:admin` | | `phone calls` | `phone:read:admin` (需要在账户上启用 Zoom Phone) |
**如果遇到范围错误**，请访问 https://marketplace.zoom.us/ → 您的应用 → Scopes，并添加错误消息中列出的缺失范围。
## 速率限制
Zoom API 具有速率限制（因端点而异，通常为 30-100 次/秒）。该脚本会通过自动重试来处理 429 响应。