Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 possède un plan. Les plans contiennent une collection de tâches plannerTasks. Les plans peuvent également avoir une collection de plannerBuckets. 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. |
| Archive plan | plannerPlan | Archive un objet plannerPlan. |
| Plan d’annulation de l’archivage | plannerPlan | Annuler l’archivage d’un objet plannerPlan archivé. |
| Déplacer vers le conteneur | plannerPlan | Déplacer un objet plannerPlan d’un plannerPlanContainer vers un autre. |
| Répertorier les compartiments de plan | collection plannerBucket | Obtenez une collection d’objets plannerBucket. |
| Répertorier les tâches de plan | collection plannerTask | Obtenez une collection d’objets plannerTask. |
| Obtenir delta | Collection plannerPlan | Obtenez les nouveaux objets plannerPlan 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 les droits d’utilisation | planUsageRight | Obtenez les droits d’utilisation d’un plan spécifique en fonction de son attribution d’étiquette de confidentialité et des autorisations de l’utilisateur demandeur. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| archiveInfo | plannerArchivalInfo | En lecture seule. Pouvant accepter la valeur Null. Contient des informations sur les personnes qui ont 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 qu’elle est 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 un conteneur. Obligatoire. |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | Affectation de l’étiquette de confidentialité pour le plan. Utilisé pour classifier et protéger le contenu du plan en fonction des stratégies organisationnelles. Cette propriété est null si aucune étiquette de confidentialité n’est affectée. Facultatif. |
| Contextes | plannerPlanContextCollection | En lecture seule. Autres expériences utilisateur dans lesquelles ce plan est utilisé, représentées en tant qu’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 | plannerPlanCreation | Contient des informations sur l’origine du plan. |
| id | String | En lecture seule. ID du plan. Il contient 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 trueest définie sur , le plan est archivé. Un plan archivé est en lecture seule. |
| title | String | Obligatoire. Titre du plan. |
| sharedWithContainers | collection plannerSharedWithContainer | Liste des conteneurs avec 2000 avec 500 conteneurs partagés. |
| propriétaire (déconseillé) | String | Utilisez plutôt la propriété conteneur . ID du groupe propriétaire du plan. Une fois qu’elle est définie, cette propriété ne peut pas être mise à jour. Cette propriété ne renvoie 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 | Détails supplémentaires sur le 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"
}