Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Un objetivo de Planner V4 asociado a un conjunto de tareas de un plan.
status (por ejemplo, en pista, en riesgo, fuera de pista) se devuelve de forma predeterminada; Las actualizaciones de la descripción, las métricas y la narrativa requieren $select.
Hereda de plannerDelta.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | Colección de objetivos | Obtenga una lista de los objetos de objetivo y sus propiedades. |
| Crear | Objetivo | Crear un nuevo objeto de objetivo. |
| Get | Objetivo | Lea las propiedades y relaciones del objeto objetivo . |
| Actualizar | Objetivo | Actualizar las propiedades de un objeto objetivo. |
| Delete | Ninguno | Eliminar un objeto de objetivo. |
| Enumerar tareas | Colección de tareas | Obtenga una lista de los objetos de tarea y sus propiedades. |
| Agregar tarea | task | Agregue tareas mediante la publicación en la colección de tareas. |
| Quitar tareas | Ninguno | Quitar un objeto de tarea . |
Propiedades
| Propiedad | Tipo | Description |
|---|---|---|
| archivalInfo | plannerArchivalInfo | Información acerca de si la entidad está archivada y cuándo se archivó. |
| capabilities | goalCapability | Indicadores de funcionalidad de solo lectura calculados por el servidor que indican qué características opcionales están habilitadas para la entidad. |
| createdBy | identitySet | Identidad del usuario (o aplicación) que creó la entidad. Solo lectura. |
| createdDateTime | DateTimeOffset | Fecha y hora en que se creó la entidad. El valor se representa en formato ISO 8601 y siempre está en hora UTC. Solo lectura. |
| displayName | Cadena | Título del objetivo. |
| extensions | extensionFieldCollection | Valores de campo de extensión personalizados establecidos en la entidad. Admite $select. |
| fecha de finalización | Fecha | Fecha en que se pretende finalizar el objetivo. |
| id | Cadena | El identificador único de la entidad. Solo lectura. Heredado de entidad |
| lastModifiedBy | identitySet | Identidad del usuario (o aplicación) que modificó por última vez la entidad. Solo lectura. |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora en que se modificó por última vez la entidad. El valor se representa en formato ISO 8601 y siempre está en hora UTC. Solo lectura. |
| notas | itemBody | Detalles o notas adicionales sobre el objetivo. |
| planId | Cadena | Identificador del plan que contiene el objetivo. Requerido e inmutable después de la creación. |
| prioridad | Int32 | Prioridad del objetivo. |
| startDate | Fecha | Fecha de inicio del objetivo. |
| status | plannerGoalStatus | Estado de progreso del objetivo. Los valores posibles son: notStarted, onTrack, behind, atRisk, closed, unknownFutureValue. |
Relaciones
| Relación | Tipo | Description |
|---|---|---|
| tasks | Colección de tareas | Colección de tareas asociadas al objetivo. Solo lectura. Admite valores NULL. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.goal",
"id": "String (identifier)",
"displayName": "String",
"planId": "String",
"status": "String",
"priority": "Int32",
"startDate": "Date",
"finishDate": "Date",
"notes": {
"@odata.type": "microsoft.graph.itemBody"
},
"archivalInfo": {
"@odata.type": "microsoft.graph.plannerArchivalInfo"
},
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"createdDateTime": "String (timestamp)",
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"capabilities": {
"@odata.type": "microsoft.graph.goalCapability"
},
"extensions": {
"@odata.type": "microsoft.graph.extensionFieldCollection"
}
}