Tipo de recurso de plan

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 plan de Planner V4. Un plan se puede detectar a través de su contenedor propio (un grupo, un canal de Teams o un usuario) y contiene cubos, tareas, objetivos, dependencias y otros datos de Planner. Un plan no tiene sentido sin su contenedor propio, por lo que container se devuelve de forma predeterminada junto con id, displayName, createdBy, createdDateTime, lastModifiedDateTimelastModifiedBy, , y archivalInfo/isArchived.

Hereda de plannerDelta.

Métodos

Método Tipo devuelto Descripción
List Colección de planes Obtener una lista de los objetos de plan y sus propiedades.
Crear plan Crear un nuevo objeto de plan.
Get plan Lea las propiedades y relaciones del objeto plan .
Actualizar plan Actualizar las propiedades de un objeto plan.
Delete Ninguno Eliminar un objeto de plan.
Enumerar depósitos Colección de cubos Obtenga una lista de los objetos de cubo y sus propiedades.
Crear cubo bucket Cree un objeto de depósito.
Contextos de lista colección planContextLink Obtener una lista de los objetos planContextLink y sus propiedades.
Crear planContextLink planContextLink Crear un nuevo objeto planContextLink.
List customFieldDefinitions Colección customFieldDefinition Obtener una lista de los objetos customFieldDefinition y sus propiedades.
Agregar customFieldDefinition customFieldDefinition Agregue customFieldDefinitions publicando en la colección customFieldDefinitions.
Quitar customFieldDefinitions Ninguno Quite un objeto customFieldDefinition .
Enumerar dependencias Colección de dependencias Obtenga una lista de los objetos de dependencia y sus propiedades.
Agregar dependencia dependencia Agregue dependencias mediante la publicación en la colección de dependencias.
Quitar dependencias Ninguno Quite un objeto de dependencia .
Enumerar objetivos Colección de objetivos Obtenga una lista de los objetos de objetivo y sus propiedades.
Agregar objetivo Objetivo Agregar objetivos publicando objetivos en la colección de objetivos.
Quitar objetivos Ninguno Quitar un objeto de objetivo .
Enumerar historialElementos colección de elementos de historial. Obtener una lista de los objetos historyItem y sus propiedades.
Agregar elemento de historial elemento de historial Agregue historyItems publicando en la colección historyItems.
Quitar historyItems Ninguno Quite un objeto historyItem .
Enumerar vínculos Colección de enlaces de contenido Obtener una lista de los objetos contentLink y sus propiedades.
Crear vínculo de contenido contentLink Crear un nuevo objeto contentLink.
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ó.
calendar planCalendar Configuración del calendario de tiempo de trabajo para el plan.
capabilities planCapability Indicadores de funcionalidad de solo lectura calculados por el servidor que indican qué características opcionales están habilitadas para la entidad.
contenedor planContainer Identifica el grupo, canal de Teams o usuario propietario del plan. Requerido e inmutable después de la creación.
contentSensitivityLabelAssignment contentSensitivityLabelAssignment La etiqueta de confidencialidad asignada al contenido asociado al plan.
creationInfo creationInfo Metadatos de creación de solo lectura para la entidad.
displayName Cadena El título del plan.
duration Int32 Duración del plan, en días.
extensions extensionFieldCollection Valores de campo de extensión personalizados establecidos en la entidad. Admite $select.
tiene chat Booleano Indica si el plan tiene un chat asociado.
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.
planView planView Configuración de vista de ámbito de planeación, incluidas las definiciones de categorías.
sharedWithContainers Colección plannerSharedWithContainer La lista de contenedores (por ejemplo, grupos o canales adicionales) con los que se comparte el plan.

Relaciones

Relación Tipo Descripción
buckets Colección de cubos Colección de cubos en el plan. Solo lectura. Admite valores NULL.
contextos colección planContextLink Colección de vínculos de contexto que describen dónde aparece el plan. Solo lectura. Admite valores NULL.
customFieldDefinitions Colección customFieldDefinition Colección de definiciones de campos personalizados en el plan. Solo lectura. Admite valores NULL.
Dependencias Colección de dependencias Colección de dependencias entre los elementos del plan. Solo lectura. Admite valores NULL.
Objetivos Colección de objetivos La colección de objetivos del plan. Solo lectura. Admite valores NULL.
elementos de historial colección de elementos de historial. La colección de elementos del historial (auditoría) del plan. Solo lectura. Admite valores NULL.
links Colección de enlaces de contenido La colección de vínculos de contenido adjuntos al plan. Solo lectura. Admite valores NULL.
tasks Colección de tareas Colección de tareas del plan. Solo lectura. Admite valores NULL.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.plan",
  "id": "String (identifier)",
  "displayName": "String",
  "container": {
    "@odata.type": "microsoft.graph.planContainer"
  },
  "calendar": {
    "@odata.type": "microsoft.graph.planCalendar"
  },
  "creationInfo": {
    "@odata.type": "microsoft.graph.creationInfo"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "planView": {
    "@odata.type": "microsoft.graph.planView"
  },
  "contentSensitivityLabelAssignment": {
    "@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"
  },
  "hasChat": "Boolean",
  "duration": "Int32",
  "sharedWithContainers": [
    {
      "@odata.type": "microsoft.graph.plannerSharedWithContainer"
    }
  ],
  "capabilities": {
    "@odata.type": "microsoft.graph.planCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}