通过 Tasks 服务,您可以使用 Apps 脚本中的 Google Tasks API。此 API 让用户能够在 Gmail 中管理任务。
参考
有关此服务的详细信息,请参阅 Tasks API 的参考文档。 与 Apps 脚本中的所有高级服务一样,Tasks 服务使用 对象、方法和参数用作公共 API。如需了解详情,请参阅如何确定方法签名。
如需报告问题和寻求其他支持,请参阅 Tasks 支持指南。
示例应用
示例网络应用 Simple Tasks 演示了如何使用 Tasks 服务。您可以查看完整的源代码 在我们的 GitHub 代码库。
示例代码
以下示例代码使用第 1 版 API。
列出任务列表
此示例列出了您账号中的任务列表。
advanced/tasks.gs
/** * Lists the titles and IDs of tasksList. * @see https://developers.google.com/tasks/reference/rest/v1/tasklists/list */ function listTaskLists() { try { // Returns all the authenticated user's task lists. const taskLists = Tasks.Tasklists.list(); // If taskLists are available then print all tasklists. if (!taskLists.items) { console.log('No task lists found.'); return; } // Print the tasklist title and tasklist id. for (let i = 0; i < taskLists.items.length; i ) { const taskList = taskLists.items[i]; console.log('Task list with title "%s" and ID "%s" was found.', taskList.title, taskList.id); } } catch (err) { // TODO (developer) - Handle exception from Task API console.log('Failed with an error %s ', err.message); } }
列出任务
此示例列出了给定任务列表中的任务。
advanced/tasks.gs
/** * Lists task items for a provided tasklist ID. * @param {string} taskListId The tasklist ID. * @see https://developers.google.com/tasks/reference/rest/v1/tasks/list */ function listTasks(taskListId) { try { // List the task items of specified tasklist using taskList id. const tasks = Tasks.Tasks.list(taskListId); // If tasks are available then print all task of given tasklists. if (!tasks.items) { console.log('No tasks found.'); return; } // Print the task title and task id of specified tasklist. for (let i = 0; i < tasks.items.length; i ) { const task = tasks.items[i]; console.log('Task with title "%s" and ID "%s" was found.', task.title, task.id); } } catch (err) { // TODO (developer) - Handle exception from Task API console.log('Failed with an error %s', err.message); } }
添加任务
此示例会向任务列表添加新任务。
advanced/tasks.gs
/** * Adds a task to a tasklist. * @param {string} taskListId The tasklist to add to. * @see https://developers.google.com/tasks/reference/rest/v1/tasks/insert */ function addTask(taskListId) { // Task details with title and notes for inserting new task let task = { title: 'Pick up dry cleaning', notes: 'Remember to get this done!' }; try { // Call insert method with taskDetails and taskListId to insert Task to specified tasklist. task = Tasks.Tasks.insert(task, taskListId); // Print the Task ID of created task. console.log('Task with ID "%s" was created.', task.id); } catch (err) { // TODO (developer) - Handle exception from Tasks.insert() of Task API console.log('Failed with an error %s', err.message); } }