Agregar tarea a un usuario

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.

Agregue tasks_v2 publicando en la colección de tasks_v2.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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 Permiso con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) No admitida. No admitida.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

POST /users/{usersId}/planner/tasks_v2/$ref

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 de tarea .

Puede especificar las siguientes propiedades al crear una tarea.

Propiedad Tipo Descripción
displayName String Título de la tarea. Obligatorio.
planId Cadena Identificador del plan que contiene la tarea. Inmutable después de la creación. Opcional.
bucketId Cadena Identificador del cubo al que pertenece la tarea. Opcional.
goalIds Colección string Identificadores de los objetivos asociados a la tarea. Opcional.
status plannerTaskStatus Indica el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed, blocked, unknownFutureValue. Opcional.
prioridad Int32 Prioridad de la tarea. Los valores admitidos van de 0 (urgente) a 10 (bajo). Obligatorio.
percentComplete Int32 Porcentaje de finalización de la tarea, que va de 0 a 100. Obligatorio.
startDateTime dateWithOptionalTime Fecha y, opcionalmente, la hora en que está programada el inicio de la tarea. Opcional.
dueDateTime dateWithOptionalTime Fecha y, opcionalmente, hora de vencimiento de la tarea. Opcional.
finishDateTime dateWithOptionalTime Fecha y, opcionalmente, hora en que finalizó la tarea. Opcional.
notas itemBody Detalles o notas adicionales sobre la tarea. Opcional.
recurrence plannerTaskPeriodence Patrón de periodicidad de la tarea, si se repite. Opcional.
planView taskPlanView Configuración de vista de tareas con ámbito del plan, como los identificadores de categoría aplicados. Opcional.
vista personal taskPersonalView Configuración de la vista personal por usuario para la tarea, como la suscripción a Mi día. Opcional.
parentTaskId Cadena Identificador de la tarea principal, si es una subtarea. Opcional.
tiene hijos Booleano Indica si la tarea tiene subtareas. Opcional.
isCritical Booleano Indica si la tarea está en la ruta crítica, tal y como se calcula a partir de sus dependencias. Opcional.
tiene chat Booleano Indica si la tarea tiene un chat asociado. Opcional.
extensions extensionFieldCollection Valores de campo de extensión personalizados establecidos en la entidad. Admite $select. Opcional.

Respuesta

Si tiene éxito, este método devuelve un código de 204 No Content respuesta y un objeto de tarea en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/users/{usersId}/planner/tasks_v2/$ref
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.task",
  "displayName": "Prepare quarterly report",
  "planId": "b3d9f9a2-3e14-4a4b-9b2b-6b6d9e6a2f31",
  "bucketId": "9c9c7a3d-5b7f-45e9-9df9-9f8b0f7edc9a",
  "goalIds": [
    "3f8a1c9d-6b42-4e7a-9d31-8c2f6b9a4e17"
  ],
  "status": "notStarted",
  "priority": 5,
  "percentComplete": 0,
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime",
    "date": "2026-06-01",
    "isTimeSpecified": false
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime",
    "date": "2026-06-15",
    "isTimeSpecified": false
  },
  "notes": {
    "@odata.type": "microsoft.graph.itemBody",
    "content": "Compile Q2 sales figures and prepare summary slides.",
    "contentType": "text"
  },
  "recurrence": {
    "@odata.type": "microsoft.graph.plannerTaskRecurrence",
    "schedule": {
      "@odata.type": "microsoft.graph.plannerRecurrenceSchedule",
      "patternStartDateTime": "2026-06-01T00:00:00Z",
      "pattern": {
        "@odata.type": "microsoft.graph.recurrencePattern",
        "type": "weekly",
        "interval": 1,
        "daysOfWeek": [
          "monday"
        ],
        "firstDayOfWeek": "sunday"
      }
    }
  },
  "planView": {
    "@odata.type": "microsoft.graph.taskPlanView",
    "appliedCategoryIds": [
      "e4f8a3c6-9d21-4b7a-8e42-6c1f9a3d5b28"
    ]
  },
  "personalView": {
    "@odata.type": "microsoft.graph.taskPersonalView",
    "isOnMyDay": true
  },
  "parentTaskId": "2c8f4b6a-9d31-4e7c-8a52-3f6b9d2e4c81",
  "hasChildren": false,
  "isCritical": false,
  "hasChat": false,
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection",
    "projectCode": "PRJ-4521"
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

HTTP/1.1 204 No Content
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.task",
  "id": "86d64a5b-109d-39c9-dd43-d7fffb6a1670",
  "displayName": "String",
  "planId": "String",
  "bucketId": "String",
  "goalIds": [
    "String"
  ],
  "status": "String",
  "priority": "Integer",
  "percentComplete": "Integer",
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "finishDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "notes": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "creationInfo": {
    "@odata.type": "microsoft.graph.creationInfo"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "completedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "completedDateTime": "String (timestamp)",
  "recurrence": {
    "@odata.type": "microsoft.graph.plannerTaskRecurrence"
  },
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "planView": {
    "@odata.type": "microsoft.graph.taskPlanView"
  },
  "personalView": {
    "@odata.type": "microsoft.graph.taskPersonalView"
  },
  "parentTaskId": "String",
  "hasChildren": "Boolean",
  "isCritical": "Boolean",
  "hasChat": "Boolean",
  "capabilities": {
    "@odata.type": "microsoft.graph.taskCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}
  • Se actualizó por última vez el