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. Longueur maximale autorisée: 1 024 caractères.
updated

string

Uniquement en sortie. Heure de la dernière modification de la tâche (au format 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" 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 (à partir d'espaces Chat ou de 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. Longueur maximale autorisée: 8 192 caractères.
status

string

État de la tâche. Il peut s'agir de "needsAction" ou de "completed".
due

string

Date limite de la tâche (au format code temporel RFC 3339). Facultatif. La date limite n'enregistre que des informations sur la date. La partie "heure" du code temporel est supprimée lors de la définition de la date limite. Il n'est pas possible de lire ni d'écrire l'heure d'échéance d'une tâche via l'API.
completed

string

Date de fin de la tâche (au format de code temporel RFC 3339). Ce champ est omis si la tâche n'est pas terminé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, auquel cas la tâche attribuée et la tâche d'origine (dans Docs ou Chat Spaces) sont supprimées. Pour supprimer uniquement la tâche attribuée, accédez à la surface de devoir et annulez son attribution. La valeur par défaut est "False" (faux).
hidden

boolean

Indicateur indiquant si la tâche est masquée. Cela se produit si la tâche a été marquée comme terminée la dernière fois que la liste de tâches 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 langage HTML: tout ce qui se trouve entre <a> et </a>.
links[].link

string

L'URL.
assignmentInfo

object (AssignmentInfo)

Uniquement en sortie. Informations contextuelles pour les tâches attribuées. Vous pouvez attribuer une tâche à un utilisateur, actuellement 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 l'origine de l'attribution. 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 de laquelle cette tâche a été attribuée. Actuellement limité à DOCUMENT ou ESPACE.
Champ d'union surface_info. Informations sur la surface (Documents, 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 à l'origine de cette tâche. 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 depuis 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, 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. Clé de ressource requise pour accéder aux fichiers partagés via un lien partagé. 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. 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.