Skip to main content

Module google_tasks

Module google_tasks 

Source
Expand description

Google Tasks, over its REST API (v1): Google’s CalDAV keeps no task, so a Google account’s task lists come this way. Each list is a folder of VTODO files like any other (calendars/<account>/tasks-<id>), read by the rest of Sioul as it reads a CalDAV list. Google keeps a title, notes, done or not, a day (no hour), and one level of steps; what it does not keep shows greyed in the task form (sioul_core::capabilities). Lines Google does not know stay in the file here.

What changed here goes first: lists made, renamed or deleted; tasks inserted, patched and moved under their parent, deleted. Then what changed there since the last sync (updatedMin, deletions included). A task changed on both sides between two syncs: yours is sent, and Google’s answer is what stays.

Structs§

Api 🔒
The API, with the account’s access token: asked again once when refused.

Constants§

API 🔒

Functions§

api 🔒
fields_of
What Google keeps of a task, as its API takes it.
files 🔒
forget_gone 🔒
Lists deleted on Google go here too, unless something here was never sent.
google_lines 🔒
What Google says of a task, as VTODO lines.
hash_of 🔒
is_tasks_list
Whether a collection’s address is a Google Tasks list.
list_id 🔒
list_url 🔒
Where a list is, as its state keeps it.
merged
The task’s file with what Google keeps written again from its answer; the rest (lines Google does not know, alarms) stays as it was.
moved 🔒
A task put under another (or at the top, None); Google’s answer.
pull 🔒
What changed there since the last sync; everything the first time, and then what is no longer there is gone here too.
push 🔒
What changed here, sent: deleted, changed (patched, moved under its parent), new (inserted, parents first: Google has one level of steps). The state follows each answer, and is kept after each task made on Google.
send_list_changes 🔒
Lists made, renamed or deleted here, told to Google. A list deleted here that holds tasks there (added elsewhere meanwhile) comes back.
skeleton 🔒
A task Google made: its own id as UID.
stamp 🔒
“2026-10-03T12:00:00.000Z” → “20261003T120000Z”.
sync
Syncs a Google account’s task lists; nothing when tasks were not given.
sync_list 🔒
tasks_granted 🔒
Whether the access given covers tasks (you may untick it on Google’s page).
uid_in 🔒
The UID in a task’s file.