Tasks 服務可讓您使用 Google Tasks API。這個 API 可讓使用者在 Gmail 中管理工作。
參考資料
如要進一步瞭解這項服務,請參閱 Tasks API 的參考說明文件。 Tasks 服務與 Apps Script 的所有進階服務一樣 包括物件、方法和參數詳情請參閱如何判定方法簽章。
如要回報問題及尋求其他支援,請參閱 Tasks 支援指南。
應用程式範例
範例應用程式的「簡易工作」範例示範如何使用 Tasks 讀取與寫入作業您可以查看完整的原始碼 的 GitHub 存放區。
程式碼範例
以下程式碼範例使用 API 的 第 1 版。
列出工作清單
這個範例會列出您帳戶中的工作清單。
進階/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); } }
列出工作
這個範例會列出指定工作清單中的工作。
進階/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); } }
新增任務
這個範例會將新工作新增至工作清單。
進階/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); } }