שירות Tasks

שירות Tasks מאפשר לכם להשתמש ב-Google Tasks API ב-Apps Script. ממשק ה-API הזה מאפשר למשתמשים לנהל את המשימות שלהם ב-Gmail.

הערה: זהו שירות מתקדם שצריך להפעיל לפני שמשתמשים בו.

חומרי עזר

למידע מפורט על השירות הזה, קראו את מאמרי העזרה של Tasks API. כמו כל השירותים המתקדמים ב-Apps Script, שירות Tasks משתמש באותם אובייקטים, שיטות ופרמטרים כמו ה-API הציבורי. מידע נוסף זמין במאמר איך נקבעות חתימות השיטות.

כדי לדווח על בעיות ולקבל תמיכה נוספת, אפשר לעיין במדריך התמיכה של Tasks.

אפליקציה לדוגמה

באפליקציית האינטרנט לדוגמה Simple Tasks מוסבר איך להשתמש בשירות 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);
  }
}