GOOGLE TASKS

L'application Google Tasks est utile pour recenser, gérer et modifier vos tâches. Ce service est intégré dans plusieurs applications de Google Workspace comme Gmail, Google Calendar, Google Sheets,...

Les développeurs de Google nous ont également donné une suite de fonctions permettant de manipuler Google Tasks. Découvrons ensemble comment accéder aux données de cette application.

Activation de l'API

En informatique, une interface de programmation applicative (souvent désignée par le terme API pour Application Programming Interface) est un ensemble normalisé de classes, de méthodes, de fonctions et de constantes qui sert de façade par laquelle un logiciel offre des services à d'autres logiciels.

Une API de Google Workspae est donc une boite à outils et les outils sont des fonctions permettant d'utiliser un logiciel, ici Google Tasks, depuis AppScript ou une autre plateforme de développement.

Dans notre cas, l'API de Google Tasks doit être activée dans notre script avant d'être utilisée. Pour ce faire :

• Depuis GAS, cliquez sur le + à coté de Service dans le menu de gauche

• Activez ensuite l'API Google Tasks

Les fonctions

• Tasklists.list().items[0].id

Cette fonction permet de récupérer l'identifiant de votre liste principale, c'est à dire celle qui ce situe dans la première position du tableau renvoyé par Tasklists.list().items

• Task.Task.list(taskListId , optionalArgs).items :

Cette fonction permet de renvoyer les des tâches d'une liste dont l'identifiant est passé en paramètre. Le paramètre optionalArgs défini un filtre lors de la récupération des tâches. Plus d'information sur ces critères de recherche ici

Les différents attributs d'un objet tâche sont exposés ici

function Lister_Taches(){

//L'identifiant de notre liste de taches

var taskListId="MTUxMDg0NDk3ODE5MDAwMjcyOTg6MDow"

//La variable optionalArgs va filter les tâches terminés, cachées et dont la date d'exécution est > au 1er Janvier 2020

var optionalArgs = {

"showCompleted": true,

"showHidden": true,

"completedMin": "2020-01-01T01:01:00.000Z",

};

//Récupération de la liste filtrée avec optionalArgs

var tasks = Tasks.Tasks.list(taskListId , optionalArgs);

//Si la variable possède un tableau, c'est à dire si des tâches ont été récupérées suivant les critères

if (tasks.items) {

//Parcours du tableau

for (var i = 0; i < tasks.items.length; i++) {

var task = tasks.items[i];

//Enregistrement des différentes données de la tâche

Logger.log(task.title, task.status , task.hidden, task.completed, task.due, task.kind,task.etag)

}

}

}

• Tasks.Tasks.get(taskListId, id_task) :

Cette fonction permet de récupérer une tâche à partir de l'identifiant d'une liste et de l'identifiant de la tâche. Cette fonction renvoie un objet possédant les attributs d'une tâche : title, notes,due,.... Cette liste d'attributs est accessible via ce lien : tasks#resource-representations