如何从创建的Google Space中获取对应的taskList ID？

API 探路者

2026-7-13

解决方案：获取Google Space对应的任务列表ID

要获取Google Space关联的任务列表ID，核心在于利用Spaces API的完整视图参数，结合授权权限来获取关联数据。以下是具体步骤和代码示例：

1. 配置必要的API与权限

确保你的Apps Script项目完成以下设置：

开启Google Spaces API和Google Tasks API（在编辑器左侧「扩展」→「Apps Script」→「服务」中找到并启用）
授权范围需包含：https://www.googleapis.com/auth/spaces、https://www.googleapis.com/auth/tasks

2. 通过Spaces API获取完整Space信息

创建Space的spaces.create接口默认只返回基础视图数据，不会包含任务列表关联信息。你需要调用spaces.get接口并指定view=FULL参数，才能拿到包含任务列表的完整Space数据：

function getSpaceTaskListId(spaceId) {
  // 调用Spaces API获取Space完整信息
  const space = Spaces.Spaces.get(spaceId, {view: 'FULL'});
  // 提取关联的任务列表ID
  return space.taskList?.id;
}

返回的taskList.id就是创建任务所需的列表ID，格式通常为spaces/<你的Space ID>。

3. 使用任务列表ID创建关联任务

拿到ID后，直接调用Tasks API插入任务即可：

function createSpaceAssociatedTask(spaceId, taskTitle) {
  const taskListId = getSpaceTaskListId(spaceId);
  if (!taskListId) {
    throw new Error("未找到Space关联的任务列表，请检查权限或Space同步状态");
  }
  
  // 构造任务对象（可按需添加备注、截止时间等字段）
  const task = {
    title: taskTitle,
    notes: "关联自Google Space"
  };
  
  // 插入任务到对应列表
  Tasks.Tasks.insert(task, taskListId);
}