Crear elemento de lista de comprobación

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Crea un nuevo objeto checklistItem como subtarea en un todoTask mayor.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet

Permissions

En las tablas siguientes se muestran los permisos con privilegios mínimos necesarios para llamar a esta API en cada tipo de recurso admitido. Siga las prácticas recomendadas para solicitar permisos con privilegios mínimos. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Permisos que actúan sobre sí mismos

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Tasks.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) Tasks.ReadWrite No disponible.
Aplicación No admitida. No admitida.

Permisos que actúan sobre otros usuarios

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Tasks.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) Tasks.ReadWrite No disponible.
Aplicación Tasks.ReadWrite.All No disponible.

Solicitud HTTP

Permisos para crear un elemento de lista de comprobación en una tarea del usuario que ha iniciado sesión:

POST /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

Permisos para crear un elemento de lista de comprobación en una tarea de otro usuario:

POST /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto checklistItem .

Puede especificar las siguientes propiedades al crear un elemento de comprobación.

Propiedad Tipo Descripción
checkedDateTime DateTimeOffset La fecha y hora en que finalizó checklistItem .
createdDateTime DateTimeOffset La fecha y hora en que se creó el elemento de lista de comprobación .
displayName Cadena Campo que indica el título de checklistItem.
isChecked Booleano Estado que indica si el elemento está marcado o no.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto checklistItem en el cuerpo de la respuesta.

Ejemplos

Solicitud

POST https://graph.microsoft.com/beta/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistItems/
Content-Type: application/json

{
    "displayName": "Final sign-off from the team"
}

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems/$entity",
    "displayName": "Final sign-off from the team",
    "createdDateTime": "2021-11-17T05:35:03.9736453Z",
    "isChecked": false,
    "id": "e3a26c2e-7c6f-4317-9d71-c27267008202"
}