Créer todoTaskList
Espace de noms: microsoft.graph
Créez un objet lists.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
---|---|
Déléguée (compte professionnel ou scolaire) | Tasks.ReadWrite |
Déléguée (compte Microsoft personnel) | Tasks.ReadWrite |
Application | Tasks.ReadWrite.All |
Requête HTTP
POST /me/todo/lists
POST /users/{id|userPrincipalName}/todo/lists
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-Type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON de l’objet todoTaskList .
Le tableau suivant répertorie les propriétés qui sont requises lorsque vous créez le todoTaskList.
Propriété | Type | Description |
---|---|---|
displayName | Chaîne | Champ indiquant le titre de la liste des tâches. |
Réponse
Si elle réussit, cette méthode renvoie un 201 Created
code de réponse et un objet todoTaskList dans le corps de la réponse.
Exemples
Demande
POST https://graph.microsoft.com/v1.0/me/todo/lists
Content-Type: application/json
{
"displayName": "Travel items"
}
Réponse
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.todoTaskList",
"id": "AAMkADIyAAAhrbPWAAA=",
"displayName": "Travel items",
"isOwner": true,
"isShared": false,
"wellknownListName": "none"
}