book-google-meet

创建具有开放访问权限的 Google Meet 空间的定时 Google 日历事件。

快速开始

bash

1. 安装依赖

pip install -r requirements.txt

2. 从 Google Cloud Console 获取 OAuth 凭据

- 启用 Google Calendar API 和 Google Meet API

- 创建 OAuth 2.0 桌面应用凭据

- 下载 client_secrets.json

3. 将 client_secrets.json 放置在技能目录中

4. 运行脚本

python book_meeting.py --title 我的会议 --date 2026-03-12 --time 15:00 --duration 45 --timezone Asia/Shanghai

前提条件

1. Google Cloud 项目设置

1. 1. 前往 Google Cloud Console
2. 创建一个新项目
3. 启用 API：

- Google Calendar API - Google Meet API

2. OAuth 同意屏幕

1. 1. 前往 OAuth 同意屏幕
2. 选择外部用户类型
3. 填写应用名称和联系邮箱
4. 添加范围：https://www.googleapis.com/auth/meetings.space.settings
5. 将发布状态设置为生产环境

3. 创建 OAuth 凭据

1. 1. 前往 凭据
2. 点击创建凭据 → OAuth 客户端 ID
3. 选择桌面应用类型
4. 下载 JSON 并保存为 clientsecrets.json

替代方案： 使用环境变量代替 client_secrets.json：
bash
export GOOGLECLIENTID=your-client-id
export GOOGLECLIENTSECRET=your-client-secret

必需的 OAuth 范围

https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/meetings.space.settings

注意： 使用 meetings.space.settings（非敏感）而不是 meetings.space.created（敏感）。

使用方法

基本用法

bash
python book_meeting.py --title 团队会议 --date 2026-03-12 --time 15:00 --duration 45 --timezone Asia/Shanghai

带参与者

bash
python book_meeting.py --title 团队会议 --date 2026-03-12 --time 15:00 --duration 45 \
--timezone Asia/Shanghai \
--attendees user1@example.com,user2@example.com

带描述

bash
python book_meeting.py --title 团队会议 --date 2026-03-12 --time 15:00 --duration 45 \
--timezone Asia/Shanghai \
--description 每周同步会议

访问类型

bash

OPEN - 拥有链接的任何人都可以加入（默认）

python book_meeting.py --title 公开会议 --date 2026-03-12 --time 15:00 --duration 45 \
--timezone Asia/Shanghai --access-type OPEN

TRUSTED - 组织成员 + 受邀外部用户

python book_meeting.py --title 内部会议 --date 2026-03-12 --time 15:00 --duration 45 \ --timezone Asia/Shanghai --access-type TRUSTED

RESTRICTED - 仅限受邀者

python book_meeting.py --title 私人会议 --date 2026-03-12 --time 15:00 --duration 45 \ --timezone Asia/Shanghai --access-type RESTRICTED

命令行选项

选项	描述	默认值
--title, -t	会议标题（必需）	-
--date, -d

会议日期（YYYY-MM-DD） | - | | --time | 会议开始时间（HH:MM） | - | | --duration | 持续时间（分钟） | 45 | | --timezone, -z | 时区 | America/New_York | | --attendees | 逗号分隔的邮箱列表 | - | | --description | 会议描述 | - | | --access-type | OPEN、TRUSTED 或 RESTRICTED | OPEN | | --credentials, -c | clientsecrets.json 的路径 | clientsecrets.json | | --token-path | 存储 OAuth 令牌的路径 | meeting_token.pickle |

输出示例

🚀 步骤 1：创建带 Meet 会议的日历事件...
✅ 日历事件已创建，包含 Meet 会议
会议代码：abc-defg-hij

🚀 步骤 2：使用会议代码查找 Meet 空间...
✅ 找到 Meet 空间：spaces/xxxxxxxxxx

🚀 步骤 3：将 Meet 空间修补为 OPEN 访问...
✅ Meet 空间修补成功！
访问类型：OPEN

============================================================
✅ 会议创建成功！
============================================================

📅 标题：团队会议
🕐 开始：2026-03-12T15:00:00
🕐 结束：2026-03-12T15:45:00
🌐 时区：Asia/Shanghai

🔗 Meet 链接：https://meet.google.com/abc-defg-hij
📞 会议代码：abc-defg-hij
🔓 访问类型：OPEN
🆔 空间名称：spaces/xxxxxxxxxx

📧 日历链接：https://calendar.google.com/calendar/event?eid=...
🆔 事件 ID：xxxxxxxxxxxxxx
============================================================

工作原理

1. 1. Calendar API - 创建带 Meet 会议的事件
2. Meet API (spaces.get) - 使用会议代码查找 Meet 空间
3. Meet API (spaces.patch) - 更新空间以设置 accessType=OPEN

故障排除

403 权限被拒绝

原因： 使用 meetings.space.created 范围（敏感）而未进行额外验证。

解决方案： 改用 meetings.space.settings 范围（非敏感）。脚本中已修复。

API 未启用

在 Google Cloud Console 中启用两个 API：

• - Calendar API：https://console.developers.google.com/apis/api/calendar.googleapis.com/overview
• Meet API：https://console.developers.google.com/apis/api/meet.googleapis.com/overview

凭据无效

删除 meeting_token.pickle 以强制重新认证：
bash
rm meeting_token.pickle

文件

• - bookmeeting.py - 主脚本
• clientsecrets.json - OAuth 凭据（您提供）
• meeting_token.pickle - 缓存的 OAuth 令牌（自动生成）
• requirements.txt - Python 依赖项

安全说明

⚠️ 敏感文件：

文件	描述	安全
meetingtoken.pickle	缓存的 OAuth 令牌（包含刷新令牌）	保持安全；不需要时删除；不要提交到版本控制
clientsecrets.json

OAuth 客户端凭据 | 切勿提交到版本控制；像密码一样保护 |

⚠️ 令牌文件警告：
脚本在首次 OAuth 授权后将 meeting_token.pickle 写入磁盘。此文件包含敏感的 OAuth 令牌，包括可用于访问您 Google 账户的刷新令牌。保护此文件：

• - 不要共享
• 不要提交到版本控制
• 不再需要时删除
• 确保适当的文件权限（仅所有者可读）

参考

• - Google Calendar API
• Google Meet API
• Meet spaces.get
• Meet spaces.patch