Tipo de recurso plannerPlan

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 son propietarios de un plan. Los planes contienen una colección de plannerTasks. Los planes también pueden tener colecciones de plannerBuckets y plannerGoals. 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 Crear 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.
Desarchivar plan plannerPlan Desarchivar un objeto plannerPlan archivado.
Mover a contenedor plannerPlan Mover un objeto plannerPlan de un plannerPlanContainer a otro.
Enumerar depósitos del plan Colección plannerBucket Obtenga una colección de objetos plannerBucket.
Enumerar los objetivos del plan Colección plannerGoal Obtener los objetivos asociados al plan.
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 en un contenedor de tipo plannerRoster sin tener que realizar una lectura completa de toda la colección de recursos.
Obtener derechos de uso planUsageRight Obtenga los derechos de uso para un plan específico en función de su asignación de etiquetas de confidencialidad y los permisos del usuario solicitante.
Enumerar elementos del historial colección plannerHistoryItem Obtenga el historial de cambios realizados en las tareas de un plan.

Propiedades

Propiedad Tipo Descripción
archivalInfo plannerArchivalInfo Solo lectura. Admite valores NULL. Contiene información sobre quién archivó o desarchivó 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 establecida, esta propiedad no se podrá actualizar. Cambia cuando un plan se mueve de un contenedor a otro, mediante el movimiento del plan al contenedor. Obligatorio.
contentSensitivityLabelAssignment contentSensitivityLabelAssignment La 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 se aplica 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.
origen de creación 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 archiva. Un plan archivado es de solo lectura.
title Cadena Obligatorio. Título del plan.
sharedWithContainers Colección plannerSharedWithContainer 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 establecida, esta propiedad no se podrá 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.
Objetivos Colección plannerGoal Colección de objetivos en el plan. Solo lectura. Admite valores NULL.
elementos de historial colección plannerHistoryItem Colección de elementos del historial de las entidades del 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"
}
  • Last updated on