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
Obtener plannerPlan	plannerPlan	Leer las propiedades y las relaciones del objeto plannerPlan.
Enumerar depósitos	Colección plannerBucket	Obtenga una colección de objetos plannerBucket.
Enumerar tareas	Colección plannerTask	Obtenga una colección de objetos plannerTask.
Update	plannerPlan	Actualizar el objeto plannerPlan.
Eliminar	Ninguno	Eliminar objeto plannerPlan.
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.
Traslado de plannerPlan al contenedor	plannerPlan	Mueva un objeto plannerPlan de plannerPlanContainer a otro.

Propiedades

Propiedad	Tipo	Descripción
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.
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.
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.
title	Cadena	Obligatorio. Título del plan.
creationSource	plannerPlanCreation	Contiene información sobre el origen del 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.
sharedWithContainers	plannerSharedWithContainer (colección)	Lista de contenedores con los que se comparte el plan.

Relaciones

Relación	Tipo	Descripción
buckets	Colección plannerBucket	Colección de depósitos del plan. Solo lectura. Admite un valor 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.

{
  "contexts": {
    "48#19%3Ad128c63941b24733951ea7defd81e550%40thread%2Eskype19%3Ad128c63941b24733951ea7defd81e550%40thread%2Eskype": {
        "@odata.type": "#microsoft.graph.plannerPlanContext",
        "associationType": "Board",
        "createdDateTime": "2015-10-14T00:57:28.4698344Z",
        "displayNameSegments": [
            "Finance Team",
            "Budget Plans"
        ],
        "ownerAppId": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346"
    }
  },
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "creationSource": {"@odata.type": "#microsoft.graph.plannerPlanCreation"},
  "createdDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "container": {
    "@odata.type": "microsoft.graph.plannerPlanContainer",
    "url": "String",
    "containerId": "String",
    "type": "String"
  },
  "sharedWithContainers": [
    {
      "@odata.type": "microsoft.graph.plannerSharedWithContainer"
    }
  ],
  "title": "String"
}