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