type de ressource de tâche (déconseillé)
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Attention
L’ensemble d’API de tâches basé sur baseTask a été déprécié le 31 mai 2022 et a cessé de retourner des données le 31 août 2022. Utilisez plutôt l’API todoTask .
Représente une tâche, telle qu’un élément de travail ou un élément personnel, qui peut faire l’objet d’un suivi et d’une exécution. Une tâche est toujours contenue dans une liste de tâches de base.
Cette ressource prend en charge les éléments suivants :
- Ajout de vos données en tant que propriétés personnalisées dans les extensions ouvertes.
- Abonnementles notifications de modification.
- Utilisation de la requête delta pour suivre les ajouts, les suppressions et les mises à jour incrémentiels.
Hérite de baseTask.
Méthodes
Méthode | Type de retour | Description |
---|---|---|
Répertorier les tâches | collection de tâches | Obtenez la liste des objets de tâche et leurs propriétés. |
Obtenir une tâche | task | Lire les propriétés et les relations d’un objet de tâche . |
Mettre à jour une tâche | task | Mettez à jour les propriétés d’un objet de tâche . |
Supprimer une tâche | Aucun | Supprime un objet de tâche . |
Déplacer | baseTask | Déplacez le message vers une autre liste. |
Lister les éléments de liste de vérification | collection checklistItem | Obtenez les ressources checklistItem à partir de la propriété de navigation checklistItems. |
Créer un objet checklistItem | checklistItem | Créez un objet checklistItem. |
Répertorier linkedResources | linkedResource_v2 collection | Obtenez les ressources linkedResource_v2 à partir de la propriété de navigation linkedResources. |
Créer une ressource liée | linkedResource_v2 | Créez un objet linkedResource_v2. |
Propriétés
Propriété | Type | Description |
---|---|---|
textbody | itemBody | Corps de la tâche au format texte qui contient généralement des informations sur la tâche. Hérité de baseTask. |
bodyLastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification de la tâche. Par défaut, le fuseau est UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande. La valeur de la propriété utilise le format ISO 8601, toujours en heure UTC. Par exemple, minuit UTC le 1er janvier 2020 se présente comme suit : « 2020-01-01T00:00:00Z ». Hérité de baseTask. |
completedDateTime | DateTimeOffset | Date à laquelle la tâche a été terminée. Hérité de baseTask. |
createdDateTime | DateTimeOffset | Date et heure de création de la tâche. Par défaut, cette valeur est définie dans le fuseau horaire UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande. La valeur de la propriété utilise le format ISO 8601. Par exemple, minuit UTC le 1er janvier 2020 se présente comme suit : « 2020-01-01T00:00:00Z ». Hérité de baseTask. |
displayName | Chaîne | Nom de la tâche. Hérité de baseTask. |
dueDateTime | dateTimeTimeZone | La date dans le fuseau horaire spécifié à laquelle la tâche doit être terminée. Hérité de baseTask. |
id | Chaîne | Identificateur unique de la tâche. Par défaut, cette valeur ne change pas si une tâche est déplacée d’une liste à une autre. Hérité de baseTask. |
importance | importance | Importance de la tâche. Les valeurs possibles sont low , normal et high . Hérité de baseTask. Les valeurs possibles sont low , normal , high . |
lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification de la tâche. Par défaut, le fuseau est UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande. La valeur de la propriété utilise le format ISO 8601, toujours en heure UTC. Par exemple, minuit UTC le 1er janvier 2020 se présente comme suit : « 2020-01-01T00:00:00Z ». Hérité de baseTask. |
point de vue | taskViewpoint | Propriétés personnelles pour un utilisateur, telles que reminderDateTime et les catégories. Hérité de baseTask. |
recurrence | patternedRecurrence | Modèle de périodicité pour la tâche. Hérité de baseTask. |
startDateTime | dateTimeTimeZone | La date dans le fuseau horaire spécifié à laquelle la tâche doit commencer. Hérité de baseTask. |
status | taskStatus_v2 | Indique l’état ou la progression de la tâche. Les valeurs possibles sont les suivantes : notStarted , inProgress , completed , ,unknownFutureValue . Hérité de baseTask. |
Relations
Relation | Type | Description |
---|---|---|
checklistItems | collection checklistItem | Collection de checklistItems liés à une tâche. Hérité de baseTask |
extensions | collection extension | Collection d’extensions ouvertes définies pour la tâche . Hérité de baseTask |
linkedResources | linkedResource_v2 collection | Collection de ressources liées à la tâche. Hérité de baseTask |
parentList | baseTaskList | Liste qui contient la tâche. Hérité de baseTask |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.task",
"textBody": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"displayName": "String",
"status": "String",
"viewpoint": {
"@odata.type": "microsoft.graph.taskViewpoint"
},
"id": "String (identifier)"
}