REST Resource: tasks

Ressource: Task

Représentation JSON
{
  "kind": string,
  "id": string,
  "etag": string,
  "title": string,
  "updated": string,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": string,
  "completed": string,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
    {
      "type": string,
      "description": string,
      "link": string
    }
  ],
  "webViewLink": string
}
Champs
kind

string

Uniquement en sortie. Type de la ressource. Il s'agit toujours de "tasks#task".

id

string

Identifiant de la tâche.

etag

string

ETag de la ressource.

title

string

Titre de la tâche. Longueur maximale autorisée: 1 024 caractères.

updated

string

Uniquement en sortie. Heure de la dernière modification de la tâche (sous forme d'horodatage RFC 3339).

parent

string

Uniquement en sortie. Identifiant de la tâche parente. Ce champ est omis s'il s'agit d'une tâche de niveau supérieur. Ce champ est en lecture seule. Utilisez la méthode "move" pour déplacer la tâche vers un autre parent ou vers le niveau supérieur.

position

string

Uniquement en sortie. Chaîne indiquant la position de la tâche parmi les tâches sœurs sous la même tâche parente ou au niveau supérieur. Si cette chaîne est supérieure à la chaîne de position correspondante d'une autre tâche par ordre lexicographique, la tâche est positionnée après l'autre tâche sous la même tâche parente (ou au niveau supérieur). Utilisez la méthode "move" pour déplacer la tâche vers un autre emplacement.

notes

string

Notes décrivant la tâche. Facultatif. Ne doit pas dépasser 8 192 caractères.

status

string

État de la tâche. La valeur est "needsAction" ou "completed".

due

string

Date d'échéance de la tâche (sous forme de code temporel RFC 3339). Facultatif. La date limite enregistre uniquement les informations de date ; la partie heure de l'horodatage est supprimée lors de la définition de la date limite. Il est impossible de lire ou d'écrire l'heure d'échéance d'une tâche via l'API.

completed

string

Date d'achèvement de la tâche (sous forme d'horodatage RFC 3339). Ce champ est omis si la tâche n'est pas terminée.

deleted

boolean

Indique si la tâche a été supprimée. La valeur par défaut est "False" (faux).

hidden

boolean

Indique si la tâche est masquée C'est le cas si la tâche a été marquée comme terminée lors de la dernière fois que la liste a été effacée. La valeur par défaut est "False" (faux). Ce champ est en lecture seule.

links[].type

string

Type du lien (par exemple, "e-mail").

links[].description

string

La description. En HTML, énoncez ce qui suit: tout ce qui se trouve entre <a> et </a>.

links[].link

string

L'URL.

Méthodes

clear

Efface toutes les tâches terminées de la liste de tâches spécifiée.

delete

Supprime la tâche spécifiée de la liste de tâches.

get

Renvoie la tâche spécifiée.

insert

Crée une tâche dans la liste de tâches spécifiée.

list

Renvoie toutes les tâches de la liste spécifiée.

move

Déplace la tâche spécifiée vers une autre position dans la liste de tâches.

patch

Met à jour la tâche spécifiée.

update

Met à jour la tâche spécifiée.