Serviço do Tarefas

Com o serviço Tarefas, é possível usar a API Google Tasks no Apps Script. Essa API permite que os usuários gerenciem as tarefas no Gmail.

Referência

Para informações detalhadas sobre esse serviço, consulte a documentação de referência da API Tasks. Assim como todos os serviços avançados no Apps Script, o serviço Tasks usa os mesmos objetos, métodos e parâmetros que a API pública. Para mais informações, consulte Como as assinaturas de método são determinadas.

Para relatar problemas e encontrar outras opções de suporte, consulte o guia de suporte do Google Tarefas.

Exemplo de aplicativo

O aplicativo da Web de exemplo Simple Tasks demonstra como usar o serviço Tasks para operações de leitura e gravação. Confira o código-fonte completo no repositório do GitHub.

Código de amostra

O exemplo de código abaixo usa a versão 1 da API.

Listar listas de tarefas

Este exemplo lista as listas de tarefas na sua conta.

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

Listar tarefas

Este exemplo lista as tarefas em uma determinada lista de tarefas.

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

Adicionar tarefa

Este exemplo adiciona uma nova tarefa a uma lista de tarefas.

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