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 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.
Plan d’archivage	plannerPlan	Archiver 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.

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.
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.
id	Chaîne	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	Chaîne	Obligatoire. Titre du plan.
creationSource	plannerPlanCreation	Contient des informations sur l’origine du plan.
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.
sharedWithContainers	collection plannerSharedWithContainer	Liste des conteneurs avec 2000 avec 500 conteneurs partagés.

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.

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