Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 To-Do basé sur baseTask a été déconseillé le 31 mai 2022 et a cessé de retourner des données le 31 août 2022. Utilisez plutôt l’API todoTask .
Type abstrait qui représente une tâche, telle qu’un travail ou un objet personnel, qui peut être suivie et terminée.
Il s’agit d’un type de base hérité par la ressource de tâche .
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| Liste baseTasks | collection baseTask | Obtenez une liste des objets baseTask et de leurs propriétés. |
| Créer une tâche de base | baseTask | Créez un objet baseTask . |
| Obtenir baseTask | baseTask | Lire les propriétés et les relations d’un objet baseTask . |
| Mettre à jour baseTask | baseTask | Mettez à jour les propriétés d’un objet baseTask . |
| Supprimer baseTask | Aucun | Supprime un objet baseTask . |
| Déplacer | baseTask | Déplacer le message vers une autre liste. |
| delta | collection baseTask | Obtenir un ensemble d’objets baseTask qui ont été ajoutés, supprimés ou mis à jour dans une liste spécifiée. |
| Liste de vérificationÉléments | liste de contrôleCollection d’objets | Obtenez les ressources checklistItem à partir de la propriété de navigation checklistItems. |
| Créer une liste de contrôleItem | checklistItem | Créez un objet checklistItem . |
| Liste des ressources liées | Collection linkedResource_v2 | Obtenez les ressources linkedResource_v2 à partir de la propriété de navigation linkedResources. |
| Créer linkedResource_v2 | linkedResource_v2 | Créez un objet linkedResource_v2 . |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| corps du texte | String | Corps de la tâche au format texte qui contient généralement des informations sur la tâche. |
| 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 ressemblerait à ceci : « 2020-01-01T00:00:00Z ». |
| completedDateTime | DateTimeOffset | Date à laquelle la tâche a été terminée. |
| 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 ressemblerait à ceci : « 2020-01-01T00:00:00Z ». |
| displayName | String | Nom de la tâche. |
| dueDateTime | dateTimeTimeZone | La date dans le fuseau horaire spécifié à laquelle la tâche doit être terminée. |
| 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. |
| importance | importance | L’importance de la tâche. Les valeurs possibles sont low, normal, high. 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 ressemblerait à ceci : « 2020-01-01T00:00:00Z ». |
| Point de vue | taskViewpoint | Propriétés propres à un utilisateur, telles que reminderDateTime et les catégories. |
| recurrence | patternedRecurrence | Modèle de périodicité pour la tâche. |
| startDateTime | dateTimeTimeZone | La date dans le fuseau horaire spécifié à laquelle la tâche doit commencer. |
| statut | taskStatus_v2 | Indique l’état ou la progression de la tâche. Les valeurs possibles sont les suivantes : notStarted, , inProgresscompleted,unknownFutureValue. |
Relations
| Relation | Type | Description |
|---|---|---|
| Liste de contrôleItems | liste de contrôleCollection d’objets | Collection de tâches secondaires plus petites liées à la tâche parent plus complexe. |
| extensions | collection extension | L’ensemble des extensions ouvertes définies pour la tâche. |
| linkedResources | Collection linkedResource_v2 | Collection de ressources liées à la tâche. |
| liste parente | baseTaskList | Liste qui contient la tâche. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.baseTask",
"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)"
}