超级管理员服务账号访问Google Workspace资源日历失败问题咨询

核心问题 #

你当前的错误根源在于：资源日历（如会议室）不是普通域用户账号，不能通过setSubject()进行身份模拟——这个方法仅适用于模拟域内的用户账号，而资源日历的@resource.calendar.google.com邮箱不属于用户实体，所以会触发「用户未找到」或「无效身份模拟」错误。

正确实现方式 #

不需要模拟资源日历身份，直接通过服务账号的全域授权权限，以资源日历的邮箱作为日历ID调用API即可。修改代码如下：

$client = new Client();
$client->setApplicationName($this->getName());
$client->setAuthConfig("{$this->configLocation}/{$this->keyReceiving}"); // Service Account JSON Key
// 移除setSubject()——不需要模拟资源日历身份
$client->setScopes([Calendar::CALENDAR, Calendar::CALENDAR_EVENTS]); // 仅保留日历事件相关权限即可

$calendarService = new Calendar($client);
// 用资源日历邮箱替换"primary"作为目标日历ID
$events = $calendarService->events->listEvents($resource->getResourceEmail());

关键验证点 #

• 确认服务账号的全域授权范围已包含Calendar::CALENDAR和Calendar::CALENDAR_EVENTS（Directory::ADMIN_DIRECTORY_RESOURCE_CALENDAR仅用于管理资源本身，访问事件无需此权限）。
• 超级管理员手动测试时，需直接使用资源日历邮箱作为API调用的日历ID，而非"primary"，这是之前出现404的原因。
• 确保资源日历的共享设置允许域内服务账号访问（配置全域授权后通常自动生效，若仍有问题可手动添加服务账号邮箱到资源日历的共享列表）。

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