Tipo de recurso de objetivo

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"
  }
}