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 (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. Utiliser l'action "Déplacer" pour déplacer la tâche vers un autre niveau parent ou vers le niveau supérieur. Une tâche parente ne peut jamais être une tâche attribuée (depuis les espaces Chat et Docs). Ce champ est en lecture seule.
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). Utiliser l'action "Déplacer" pour déplacer la tâche vers un autre emplacement.
notes

string

Notes décrivant la tâche. Les tâches attribuées à partir de Google Docs ne peuvent pas comporter de notes. Facultatif. Ne doit pas dépasser 8 192 caractères.
status

string

État de la tâche. Il s'agit de "needsAction" ou "terminée".
due

string

Date d'échéance de la tâche (sous forme de code temporel RFC 3339). Facultatif. La date limite n'enregistre que les informations de date. la partie correspondant à l'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. Pour les tâches attribuées, ce champ est en lecture seule. Elles ne peuvent être supprimées qu'en appelant la méthode "tasks.delete". Dans ce cas, la tâche attribuée et la tâche d'origine (dans les espaces Docs ou 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 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 "email".
links[].description

string

La description. En HTML, parlez: 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 depuis des surfaces comme Docs et Chat Space. Ce champ est renseigné pour les tâches attribuées à l'utilisateur actuel et identifie leur source. 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 d'où provient cette tâche attribuée. Actuellement limité à DOCUMENT ou SPACE.
Champ d'union surface_info. Informations sur la surface (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 d'où provient 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 dans Gmail.
DOCUMENT La tâche est attribuée à partir d'un document.
SPACE La tâche est attribuée à partir d'un espace Chat.

DriveResourceInfo

Informations sur la ressource Drive d'où provient une tâche (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é d'accès à la ressource requise pour accéder aux fichiers partagés via un lien partagé. Non obligatoire pour tous les fichiers. Voir aussi 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. Le format est "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 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.