Compartir a través de


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