type de ressource plannerPlan

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente un plan dans Microsoft 365. Un groupe ou un utilisateur est propriétaire d’un plan. Les plans contiennent une collection de PlannerTasks. Les plans peuvent également avoir des collections de compartiments planner et de plannerGoals. Chaque objet de plan possède un objet details qui peut contenir des informations supplémentaires sur le plan. Pour plus d’informations sur les relations entre les groupes, les plans et les tâches, reportez-vous à Planner.

Méthodes

Méthode Type renvoyé Description
Créer plannerPlan Créez un objet plannerPlan .
Obtenir plannerPlan Lisez les propriétés et les relations de l’objet plannerPlan.
Mettre à jour plannerPlan Mettez à jour l’objet plannerPlan.
Delete Aucun Supprimer l’objet plannerPlan.
Plan d’Archive plannerPlan Archive un objet plannerPlan.
Désarchiver le plan plannerPlan Désarchivez un objet plannerPlan archivé.
Déplacer vers le conteneur plannerPlan Déplacer un objet plannerPlan d’un plannerPlanContainer à un autre.
Répertorier les compartiments de plan collection plannerBucket Obtenez une collection d’objets plannerBucket.
Répertorier les objectifs du plan Collection plannerGoal Obtenez les objectifs associés au plan.
Répertorier les tâches de plan collection plannerTask Obtenez une collection d’objets plannerTask.
Obtenir delta Collection plannerPlan Obtenez des objets plannerPlan nouvellement créés, mis à jour ou supprimés dans un conteneur de type groupe ou plannerRoster sans avoir à effectuer une lecture complète de l’ensemble de la collection de ressources.
Obtenir des droits d’utilisation planUsageRight Obtenez les droits d’utilisation d’un plan spécifique en fonction de l’attribution de son étiquette de confidentialité et des autorisations de l’utilisateur demandeur.
Répertorier les éléments de l’historique collection plannerHistoryItem Obtenez l’historique des modifications apportées aux tâches au sein d’un plan.

Propriétés

Propriété Type Description
archivalInfo plannerArchivalInfo En lecture seule. Pouvant accepter la valeur Null. Contient des informations sur qui a archivé ou désarchivé le plan et pourquoi.
conteneur plannerPlanContainer Identifie le conteneur du plan. Spécifiez toutes les propriétés ou spécifiez uniquement l’URL, le containerId et le type. Une fois définie, cette propriété ne peut pas être mise à jour. Il change lorsqu’un plan est déplacé d’un conteneur à un autre, à l’aide du déplacement de plan vers le conteneur. Obligatoire.
contentSensitivityLabelAssignment contentSensitivityLabelAssignment Affectation de l’étiquette de confidentialité pour le plan. Permet de classer et de protéger le contenu du plan en fonction des stratégies de l’organisation. Cette propriété est si aucune étiquette de confidentialité n’est null attribuée. Facultatif.
les contextes plannerPlanContextCollection En lecture seule. Autres expériences utilisateur dans lesquelles ce plan est utilisé, représentées par des entrées plannerPlanContext .
createdBy identitySet En lecture seule. Utilisateur qui a créé le plan.
createdDateTime DateTimeOffset En lecture seule. Date et heure de création du plan. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
creationSource plannerCréation de plan Contient des informations sur l’origine du plan.
id String En lecture seule. ID du plan. Il comporte 28 caractères et respecte la casse. Une validation du format est effectuée sur le service.
isArchived Boolean En lecture seule. Si la valeur est , truele plan est archivé. Un plan archivé est en lecture seule.
title String Obligatoire. Titre du plan.
sharedWithContainers collection plannerSharedWithContainer Liste des conteneurs avec lesquels le plan est partagé.
propriétaire (déconseillé) String Utilisez plutôt la propriété conteneur . ID du groupe propriétaire du plan. Une fois définie, cette propriété ne peut pas être mise à jour. Cette propriété ne retourne pas d’ID de groupe valide si le conteneur du plan n’est pas un groupe.

Relations

Relation Type Description
compartiments collection plannerBucket Collection de compartiments dans le plan. En lecture seule. Pouvant accepter la valeur Null.
détails plannerPlanDetails Informations supplémentaires sur le plan. En lecture seule. Pouvant accepter la valeur Null.
Objectifs Collection plannerGoal Ensemble d’objectifs dans le plan. En lecture seule. Pouvant accepter la valeur Null.
historyItems collection plannerHistoryItem Collection d’éléments d’historique pour les entités du plan. En lecture seule. Pouvant accepter la valeur Null.
tasks collection plannerTask Collection de tâches dans le plan. En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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