Tasks-Dienst

Mit dem Aufgaben-Dienst können Sie die Google Tasks API in Google Apps Script verwenden. Mit dieser API können Nutzer ihre Aufgaben in Gmail verwalten.

Dies ist ein erweiterter Dienst, der vor der Verwendung aktiviert werden muss werden.

Referenz

Ausführliche Informationen zu diesem Dienst finden Sie in der Referenzdokumentation zur Tasks API. Wie alle erweiterten Dienste in Apps Script verwendet der Aufgaben-Dienst dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter Methoden-Signaturen.

Informationen zum Melden von Problemen und zu Supportoptionen finden Sie im Aufgaben-Supportleitfaden.

Beispielanwendung

Die Beispiel-Webanwendung Simple Tasks zeigt, wie der Tasks-Dienst für Lese- und Schreibvorgänge verwendet wird. Der vollständige Quellcode ist in unserem GitHub-Repository verfügbar.

Beispielcode

Im folgenden Beispielcode wird Version 1 von der API verwendet.

Aufgabenlisten auflisten

In diesem Beispiel werden die Aufgabenlisten in Ihrem Konto aufgelistet.

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

Aufgaben auflisten

In diesem Beispiel werden die Aufgaben in einer bestimmten Aufgabenliste aufgelistet.

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

Aufgabe hinzufügen

In diesem Beispiel wird einer Aufgabenliste eine neue Aufgabe hinzugefügt.

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