Google Calendar API跨用户创建事件时回复邮箱异常问题

问题背景 #

我们通过Google管理员完成Workspace全工作区集成，用https://developers.google.com/calendar/api/v3/reference/events/insert API实现日历功能，权限范围为https://www.googleapis.com/auth/calendar.events。流程是传入用户Calendar ID，为该用户创建事件并添加参会者，其他功能均正常，但存在一个问题：创建事件后发送给参会者的邮件，发件人地址是正确的目标用户邮箱，但回复地址始终是完成集成的管理员邮箱，导致参会者点击「回复全部」时会自动抄送邮件给管理员。我们尝试了API内所有可调整的设置，仍无法让回复地址与发件人地址保持一致。

（问题截图说明：邮件详情显示发件人为目标用户邮箱，但回复地址字段包含管理员邮箱，参会者执行回复全部操作时，管理员会被纳入收件列表）

解决方案 #

这是因为使用管理员身份进行域级授权调用API时，默认会将授权主体（管理员）作为回复链路的一部分。要解决该问题，必须启用域范围委派（Domain-Wide Delegation），并以目标用户身份模拟调用，而非直接使用管理员身份操作：

• 确认Google Cloud控制台中，你的服务账号已启用域范围委派，且在Google Workspace Admin控制台中，为该服务账号授权了https://www.googleapis.com/auth/calendar.events权限
• 调用API时，使用服务账号密钥生成模拟目标用户的凭据，不能直接使用管理员的身份令牌。以下是Python示例代码：

from google.oauth2 import service_account
from googleapiclient.discovery import build

# 加载服务账号密钥文件
creds = service_account.Credentials.from_service_account_file(
    'your-service-account-key.json',
    scopes=['https://www.googleapis.com/auth/calendar.events']
)
# 模拟目标用户身份，替换为实际用户邮箱
delegated_creds = creds.with_subject('user@your-domain.com')

# 初始化Calendar API客户端
calendar_service = build('calendar', 'v3', credentials=delegated_creds)

# 构造事件请求体
event_payload = {
    'summary': '项目同步会议',
    'start': {'dateTime': '2024-06-15T09:30:00+08:00', 'timeZone': 'Asia/Shanghai'},
    'end': {'dateTime': '2024-06-15T10:30:00+08:00', 'timeZone': 'Asia/Shanghai'},
    'attendees': [{'email': 'attendee@external-domain.com'}]
}
# 插入事件并发送参会通知
calendar_service.events().insert(
    calendarId='user@your-domain.com',
    body=event_payload,
    sendUpdates='all'
).execute()

• 核心操作是通过with_subject方法指定目标用户邮箱，让API调用以该用户身份执行，这样生成的邮件回复地址就会与发件人（目标用户）完全一致，不会再附带管理员邮箱。

排查要点 #

若已启用域范围委派但问题仍存在，检查以下几点：

• 服务账号的域范围委派权限配置是否正确，是否遗漏了calendar.events权限
• 调用API时是否确实使用了模拟用户的凭据，而非管理员的直接身份令牌
• 确认目标用户的Calendar ID输入正确，且服务账号拥有访问该用户日历的权限

内容的提问来源于stack exchange，提问作者Andrew Cetinic