使用Google Apps Script获取日历活动全部嘉宾列表的问题

getGuestList()确实存在一些官方文档未明确提及的隐性限制，导致无法获取全部嘉宾，具体原因和解决方法如下：

一、核心限制原因 #

• 群组嘉宾无法展开：如果活动邀请的是群组邮箱，getGuestList()默认只会返回群组对象，不会自动展开群组内的成员。除非你拥有该群组的管理权限，否则无法获取群组成员的邮箱。
• 隐私隐藏的嘉宾不返回：若嘉宾设置了邮箱隐私权限（比如在Google日历中隐藏自己的邮箱），这类嘉宾不会被getGuestList()返回。
• 单页返回数量上限：当单活动嘉宾数量较多时，getGuestList()存在隐性的单页返回上限（官方未明确数值），超过上限的嘉宾会被截断，无法一次性获取全部。

二、解决方法：使用高级日历服务（Advanced Calendar Service） #

CalendarApp的基础服务功能有限，建议启用高级日历服务来绕过这些限制，它支持自定义返回嘉宾数量、展开群组成员：

1. 先在Google Apps Script编辑器中启用高级日历服务：

   • 点击「资源」→「高级Google服务」
   • 找到「Calendar API」并开启，保存设置

2. 替换原代码中的嘉宾获取逻辑，示例代码如下：

for (var i = 0; i < unique_events_list.length; i++){
    var id = unique_events_list[i];
    // 使用高级日历服务获取活动详情
    var event = Calendar.Events.get('primary', id, {
        maxAttendees: 250, // 最大返回嘉宾数，上限250
        singleEvents: true, // 展开群组嘉宾的成员
        showDeleted: false // 不包含已删除的嘉宾
    });
    var event_title = event.summary.toString().toUpperCase().trim();
    
    // 处理嘉宾列表
    if (event.attendees) {
        event.attendees.forEach(function(guest){
            // 过滤掉无邮箱的嘉宾（隐私隐藏或无效嘉宾）
            if (guest.email) {
                invitees.push([event_title, guest.email]);
            }
        });
    }
}

补充说明 #

• 高级日历服务的maxAttendees参数最大可设为250，若单活动嘉宾超过250，需要通过分页（pageToken参数）循环获取剩余嘉宾。
• 若仍无法获取某些嘉宾，大概率是该嘉宾的隐私设置或你无对应群组权限导致，这类情况无法绕过。

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