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.
Representa un plan en Microsoft 365. Un grupo o un usuario posee un plan. Los planes contienen una colección de plannerTasks. Los planes también pueden tener una colección de plannerBuckets. Cada objeto plan tiene un objeto details que puede contener más información sobre el plan. Para obtener más información sobre la relación entre los grupos, los planes y las tareas, vea Planificador.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Crear | plannerPlan | Cree un objeto plannerPlan . |
| Get | plannerPlan | Leer las propiedades y las relaciones del objeto plannerPlan. |
| Update | plannerPlan | Actualizar el objeto plannerPlan. |
| Eliminar | Ninguno | Eliminar objeto plannerPlan. |
| plan de Archivo | plannerPlan | Archivo un objeto plannerPlan. |
| Plan noarchivo | plannerPlan | Desarchivar un objeto plannerPlan archivado. |
| Mover al contenedor | plannerPlan | Mueva un objeto plannerPlan de plannerPlanContainer a otro. |
| Enumerar depósitos del plan | Colección plannerBucket | Obtenga una colección de objetos plannerBucket. |
| Enumerar tareas del plan | Colección plannerTask | Obtenga una colección de objetos plannerTask. |
| Obtener delta | Colección plannerPlan | Obtenga objetos plannerPlan recién creados, actualizados o eliminados en un grupo o un contenedor de tipos plannerRoster sin tener que realizar una lectura completa de toda la colección de recursos. |
| Obtención de derechos de uso | planUsageRight | Obtenga los derechos de uso de un plan específico en función de su asignación de etiqueta de confidencialidad y de los permisos del usuario solicitante. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| archivalInfo | plannerArchivalInfo | Solo lectura. Admite valores NULL. Contiene información sobre quién archivó o desarchó el plan y por qué. |
| contenedor | plannerPlanContainer | Identifica el contenedor del plan. Especifique todas las propiedades o especifique solo la dirección URL, el containerId y el tipo. Una vez establecido, esta propiedad no se puede actualizar. Cambia cuando un plan se mueve de un contenedor a otro, mediante el traslado del plan al contenedor. Obligatorio. |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | Asignación de etiqueta de confidencialidad para el plan. Se usa para clasificar y proteger el contenido del plan en función de las directivas de la organización. Esta propiedad es null si no se asigna ninguna etiqueta de confidencialidad. Opcional. |
| Contextos | plannerPlanContextCollection | Solo lectura. Otras experiencias de usuario en las que se usa este plan, representadas como entradas plannerPlanContext . |
| createdBy | identitySet | Solo lectura. El usuario que creó el plan. |
| createdDateTime | DateTimeOffset | Solo lectura. Fecha y hora en que se creó el plan. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| creationSource | plannerPlanCreation | Contiene información sobre el origen del plan. |
| id | Cadena | Solo lectura. Id. del plan. Tiene 28 caracteres y distingue mayúsculas de minúsculas. La validación del formato se efectúa en el servicio. |
| isArchived | Booleano | Solo lectura. Si se establece en true, el plan se archivará. Un plan archivado es de solo lectura. |
| title | Cadena | Obligatorio. Título del plan. |
| sharedWithContainers | plannerSharedWithContainer (colección) | Lista de contenedores con los que se comparte el plan. |
| propietario (en desuso) | Cadena | En su lugar, use la propiedad container. Id. del grupo que tiene el plan. Una vez establecido, esta propiedad no se puede actualizar. Esta propiedad no devuelve un identificador de grupo válido si el contenedor del plan no es un grupo. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| buckets | Colección plannerBucket | Colección de depósitos del plan. Solo lectura. Admite valores NULL. |
| details | plannerPlanDetails | Detalles adicionales sobre el plan. Solo lectura. Admite valores NULL. |
| tasks | Colección plannerTask | Colección de tareas en el plan. Solo lectura. Admite valores NULL. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"archivalInfo": {"@odata.type": "microsoft.graph.plannerArchivalInfo"},
"container": {"@odata.type": "microsoft.graph.plannerPlanContainer"},
"contentSensitivityLabelAssignment": {"@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"},
"contexts": {"@odata.type": "microsoft.graph.plannerPlanContextCollection"},
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"creationSource": {"@odata.type": "#microsoft.graph.plannerPlanCreation"},
"id": "String (identifier)",
"isArchived": "Boolean",
"owner": "String",
"sharedWithContainers": [{"@odata.type": "microsoft.graph.plannerSharedWithContainer"}],
"title": "String"
}