บริการ Tasks

บริการ Tasks ช่วยให้คุณสามารถใช้ Google Tasks API ใน Apps Script API นี้ ทำให้ผู้ใช้สามารถจัดการงานของตนเองใน Gmail

หมายเหตุ: นี่คือบริการขั้นสูงที่ เปิดใช้ก่อนใช้งาน

ข้อมูลอ้างอิง

สำหรับข้อมูลโดยละเอียดเกี่ยวกับบริการนี้ โปรดดูที่ เอกสารอ้างอิงสำหรับ Tasks API เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script บริการ Tasks จะใช้บริการเดียวกัน ออบเจ็กต์ เมธอด และพารามิเตอร์เป็น API สาธารณะ ดูข้อมูลเพิ่มเติมได้ที่วิธีกำหนดลายเซ็นของเมธอด

หากต้องการรายงานปัญหาและค้นหาการสนับสนุนอื่นๆ โปรดดู คู่มือการสนับสนุนของ Tasks

แอปพลิเคชันตัวอย่าง

ตัวอย่างการใช้งานเว็บแอปพลิเคชันอย่าง Simple Tasks แสดงวิธีการใช้งานแอปพลิเคชัน สำหรับทั้งการดำเนินการอ่านและเขียน คุณสามารถดูซอร์สโค้ดแบบเต็ม ใน ที่เก็บของ GitHub

โค้ดตัวอย่าง

โค้ดตัวอย่างด้านล่างใช้เวอร์ชัน 1 ของ API

สร้างรายการงาน

ตัวอย่างนี้แสดงรายการงานในบัญชีของคุณ

advanced/tasks.gs

ดูใน GitHub

/**
 * 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

ดูใน GitHub

/**
 * 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

ดูใน GitHub

/**
 * 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);
  }
}