如何在FullCalendar中配置Google Calendar私密事件同步？

开发者阿泽

2026-8-10

解决FullCalendar加载Google私密日历事件的方法

要加载非公开的Google日历事件，无需再依赖FullCalendar的Google Calendar API集成，直接通过Google提供的私密ICS链接即可获取事件，具体修改步骤如下：

1. 移除Google API相关配置

删除原代码中的googleCalendarApiKey配置项，因为我们将改用ICS链接直接拉取事件，不再依赖Google Calendar API接口。

2. 替换事件源为私密ICS链接

将events字段的值替换为你拿到的完整私密ICS URL，记得把链接中的CALENDAR_ID_HERE和PRIVATE_KEY_HERE替换为实际的日历ID和私密密钥。

3. 确保加载ICALendar插件

如果通过CDN引入FullCalendar，需额外添加ICALendar插件的脚本；如果用npm安装，要确保已经安装并导入@fullcalendar/icalendar包。

修改后的完整脚本示例

$(document).ready(() => {
    var calendarEl = document.getElementById('calendar');

    var calendar = new FullCalendar.Calendar(calendarEl, {
        headerToolbar: {
            left: 'prev,next today',
            center: 'title',
            right: 'dayGridMonth,listYear'
        },
        displayEventTime: false, // 不在列表视图显示时间列
        // 替换为你的私密ICS链接
        events: 'https://calendar.google.com/calendar/ical/CALENDAR_ID_HERE%40group.calendar.google.com/private-PRIVATE_KEY_HERE/basic.ics',
        eventClick: function(arg) {
            // 在弹窗中打开事件
            window.open(arg.event.url, 'google-calendar-event', 'width=700,height=600');
            arg.jsEvent.preventDefault() // 阻止在主标签页跳转
        },
        loading: function(bool) {
            document.getElementById('loading').style.display = bool ? 'block' : 'none';
        }
    });

    calendar.render();
});