Crear outlookTask (obsoleto)
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.
Precaución
La API de tareas de Outlook está en desuso y dejará de devolver datos el 20 de agosto de 2022. Use la nueva API de To Do. Para más información, consulte API To Do en versión preliminar pública.
Cree una tarea de Outlook en el grupo de tareas predeterminado (My Tasks
) y la carpeta de tareas predeterminada (Tasks
) en el buzón del usuario.
El método POST siempre omite la parte de hora de startDateTime y dueDateTime en el cuerpo de la solicitud y supone que la hora es siempre medianoche en la zona horaria especificada.
De forma predeterminada, esta operación (y las operaciones GET, PATCH y tareas completas ) devuelve propiedades relacionadas con la fecha en UTC.
Puede usar el encabezado Prefer: outlook.timezone
para que todas las propiedades relacionadas con fechas de la respuesta se representen en una zona horaria distinta de UTC.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. 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.
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. |
Solicitud HTTP
POST /me/outlook/tasks
POST /users/{id|userPrincipalName}/outlook/tasks
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Prefer: outlook.timezone | Especifica la zona horaria de las propiedades horarias de la respuesta, que estaría en UTC si no se especifica este encabezado. Opcional. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON del objeto outlookTask .
Respuesta
Si se ejecuta correctamente, este método devuelve 201 Created
el código de respuesta y el objeto outlookTask en el cuerpo de la respuesta.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra el uso del Prefer: outlook.timezone
encabezado . Crea una tarea, expresa startDateTime y dueDateTime en hora estándar oriental (EST) e incluye un Prefer
encabezado de Hora estándar del Pacífico (PST).
POST https://graph.microsoft.com/beta/me/outlook/tasks
Prefer: outlook.timezone="Pacific Standard Time"
Content-type: application/json
{
"subject": "Shop for children's weekend",
"startDateTime": {
"dateTime": "2016-05-03T09:00:00",
"timeZone": "Eastern Standard Time"
},
"dueDateTime": {
"dateTime": "2016-05-05T16:00:00",
"timeZone": "Eastern Standard Time"
}
}
En el cuerpo de la solicitud, proporcione una representación JSON del objeto outlookTask .
Respuesta
El método POST omite la parte de hora de startDateTime y dueDateTime en el cuerpo de la solicitud y supone que la hora es siempre medianoche en la zona horaria especificada (EST).
Dado que el Prefer
encabezado especifica PST, el método POST expresa todas las propiedades relacionadas con la fecha en la respuesta en PST.
En concreto, para las propiedades startDateTime y dueDateTime , el método POST convierte medianoche en EST en PST y los devuelve en PST en la respuesta.
Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.
HTTP/1.1 201 Created
Content-type: application/json
{
"id": "AAMkADA1MHgwAAA=",
"createdDateTime": "2016-04-22T15:19:18.9526004-07:00",
"lastModifiedDateTime": "2016-04-22T15:19:19.015101-07:00",
"changeKey": "1/KC9Vmu40G3DwB6Lgs7MAAAIW9XXA==",
"categories": [ ],
"assignedTo": null,
"body": {
"contentType": "Text",
"content": ""
},
"completedDateTime": null,
"dueDateTime": {
"dateTime": "2016-05-04T021:00:00.0000000",
"timeZone": "Pacific Standard Time"
},
"hasAttachments":false,
"importance": "normal",
"isReminderOn": false,
"owner": "Administrator",
"parentFolderId": "AQMkADA1MTEgAAAA==",
"recurrence": null,
"reminderDateTime": null,
"sensitivity": "Normal",
"startDateTime": {
"dateTime": "2016-05-02T21:00:00.0000000",
"timeZone": "Pacific Standard Time"
},
"status": "notStarted",
"subject": "Shop for children's weekend"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte:Enviar y ver comentarios de