Google App Maker新手求助：如何获取指定日历而非默认日历的事件？

嘿，作为Google App Maker新手遇到这个问题太正常了！我来帮你把这个问题捋清楚，其实你用CalendarApp.getCalendarsByName()的方向是对的，只是没注意到这个方法的小细节——它返回的是日历数组，而不是单个日历实例，这就是你遇到瓶颈的原因啦。

下面给你具体的解决步骤和修正后的代码：

关键提示点 #

• 首先确认日历名称完全准确：getCalendarsByName()是精确匹配的，大小写、空格都不能错，不然会找不到对应日历
• 一定要处理返回的数组：因为可能存在多个同名日历，所以必须先检查数组是否有内容，再取出具体的日历对象
• 替换默认日历调用：拿到指定日历实例后，就可以用它来调用getEvents()等方法，替代原来的CalendarApp.getDefaultCalendar()

修正后的完整代码 #

/**
 * Gets Calendar events from a specified calendar.
 * @param {Query} query - data query with parameters.
 * @return {Array<Event>} events from the specified Calendar.
 */
function getEvents_(query) {
  var startDate = query.parameters.StartDate;
  var endDate = query.parameters.EndDate; // 假设你的查询包含结束日期参数，可根据实际调整
  var targetCalendarName = "你的目标日历名称"; // 替换成你要获取的日历名称

  // 获取指定名称的日历集合（数组形式）
  var matchedCalendars = CalendarApp.getCalendarsByName(targetCalendarName);
  
  // 检查是否找到对应日历，避免后续报错
  if (matchedCalendars.length === 0) {
    throw new Error(`未找到名称为「${targetCalendarName}」的日历，请检查名称是否正确`);
  }

  // 取第一个匹配的日历（如果有多个同名，可通过getOwner()/getId()进一步筛选）
  var targetCalendar = matchedCalendars[0];

  // 获取指定时间范围内的日历事件，可根据需求添加更多筛选条件
  var rawEvents = targetCalendar.getEvents(startDate, endDate);

  // 可选：将原始事件格式化为适合App Maker使用的结构
  var formattedEvents = rawEvents.map(function(event) {
    return {
      title: event.getTitle(),
      startTime: event.getStartTime(),
      endTime: event.getEndTime(),
      description: event.getDescription(),
      location: event.getLocation()
    };
  });

  return formattedEvents;
}

额外注意事项 #

• 权限配置：确保你的App Maker项目已经授权了Calendar API权限。在脚本编辑器里点击「资源」→「高级Google服务」，找到Calendar API并启用；同时要在Google Cloud Console中确认项目的OAuth权限配置正确
• 同名日历处理：如果有多个同名日历，你可以通过targetCalendar.getOwner()获取日历所有者邮箱，或者targetCalendar.getId()获取日历ID，来精准定位你需要的那个日历
• 灵活配置日历名称：如果想让日历名称可以动态调整，可以把targetCalendarName改成从query参数获取，比如query.parameters.TargetCalendarName，这样不用修改代码就能切换不同日历

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