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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
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. La longueur maximale autorisée est de 1 024 caractères.
updated

string

Uniquement en sortie. Heure de la dernière modification de la tâche (code temporel 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 premier niveau. Utilisez la méthode "move" (déplacer) pour déplacer la tâche sous un autre parent ou au niveau supérieur. Une tâche parente ne peut jamais être une tâche attribuée (depuis les espaces Chat ou Docs). Ce champ est en lecture seule.
position

string

Uniquement en sortie. Chaîne indiquant la position de la tâche parmi ses 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 selon l'ordre lexicographique, la tâche est placé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 une autre position.
notes

string

Notes décrivant la tâche. Les tâches attribuées à partir de Google Docs ne peuvent pas comporter de notes. Facultatif. La longueur maximale autorisée est de 8 192 caractères.
status

string

État de la tâche. La valeur peut être "needsAction" ou "completed".
due

string

Date prévue pour la tâche (sous forme de code temporel RFC 3339). Facultatif. Il s'agit du jour où la tâche doit être effectuée ou où elle est visible dans la grille de l'agenda. Il ne s'agit pas de la date limite de la tâche. Seules les informations de date sont enregistrées. La partie heure du code temporel est ignorée lors de la définition de ce champ. Il n'est pas possible de lire ou d'écrire l'heure à laquelle une tâche est planifiée à l'aide de l'API.
completed

string

Date d'achèvement de la tâche (sous forme de code temporel RFC 3339). Ce champ est omis si la tâche n'a pas été effectuée.
deleted

boolean

Indicateur indiquant si la tâche a été supprimée. Pour les tâches attribuées, ce champ est en lecture seule. Elles ne peuvent être supprimées qu'en appelant tasks.delete. Dans ce cas, la tâche attribuée et la tâche d'origine (dans Docs ou les espaces Chat) sont supprimées. Pour supprimer uniquement la tâche attribuée, accédez à la surface d'attribution et annulez l'attribution de la tâche. 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 avait été marquée comme terminée lors de la dernière suppression de la liste des tâches. La valeur par défaut est "False" (faux). Ce champ est en lecture seule.
links[].type

string

Type du lien (par exemple, "email", "generic", "chat_message", "keep_note").
links[].description

string

Description (peut être vide).
links[].link

string

URL.
assignmentInfo

object (AssignmentInfo)

Uniquement en sortie. Informations contextuelles pour les tâches attribuées. Une tâche peut être attribuée à un utilisateur, ce qui est actuellement possible depuis des surfaces telles que Docs et les espaces Chat. Ce champ est renseigné pour les tâches attribuées à l'utilisateur actuel et indique d'où la tâche a été attribuée. Ce champ est en lecture seule.

AssignmentInfo

Informations sur la source de l'attribution de la tâche (document, espace Chat).

Représentation JSON 
{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  // Union field surface_info can be only one of the following:
  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
  // End of list of possible types for union field surface_info.
}
Champs
surfaceType

enum (ContextType)

Uniquement en sortie. Type de surface à partir duquel cette tâche attribuée provient. Actuellement limité à DOCUMENT ou SPACE.
Champ d'union surface_info. Informations sur la surface (Google Docs, espaces Chat) à partir de laquelle cette tâche a été attribuée. surface_info ne peut être qu'un des éléments suivants :
driveResourceInfo

object (DriveResourceInfo)

Uniquement en sortie. Informations sur le fichier Drive à partir duquel cette tâche a été créée. Actuellement, le fichier Drive ne peut être qu'un document. Ce champ est en lecture seule.
spaceInfo

object (SpaceInfo)

Uniquement en sortie. Informations sur l'espace Chat d'où provient cette tâche. Ce champ est en lecture seule.

ContextType

Produit associé à la tâche.

Enums
CONTEXT_TYPE_UNSPECIFIED Valeur inconnue pour le contexte de cette tâche.
GMAIL La tâche est créée à partir de Gmail.
DOCUMENT La tâche est attribuée à partir d'un document.
SPACE La tâche est attribuée depuis un espace Chat.

DriveResourceInfo

Informations sur la ressource Drive à partir de laquelle une tâche a été attribuée (document, feuille de calcul, etc.).

Représentation JSON 
{
  "driveFileId": string,
  "resourceKey": string
}
Champs
driveFileId

string

Uniquement en sortie. Identifiant du fichier dans l'API Drive.
resourceKey

string

Uniquement en sortie. Une clé de ressource est requise pour accéder aux fichiers partagés via un lien de partage. Il n'est pas obligatoire pour tous les fichiers. Consultez également developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Informations sur l'espace Chat à partir duquel une tâche a été attribuée.

Représentation JSON 
{
  "space": string
}
Champs
space

string

Uniquement en sortie. Espace Chat d'où provient cette tâche. Ce paramètre est au format "spaces/{space}".

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 de tâches spécifiée.

move

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

patch

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

update

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