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.