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
Obtenir un objet plannerPlan	plannerPlan	Lisez les propriétés et les relations de l’objet plannerPlan.
Répertorier les compartiments	collection plannerBucket	Obtenez une collection d’objets plannerBucket.
Répertorier les tâches	collection plannerTask	Obtenez une collection d’objets plannerTask.
Mettre à jour	plannerPlan	Mettez à jour l’objet plannerPlan.
Delete	Aucun	Supprimer l’objet plannerPlan.
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.
Déplacer plannerPlan vers un conteneur	plannerPlan	Déplacer un objet plannerPlan d’un plannerPlanContainer vers un autre.

Propriétés

Propriété	Type	Description
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.
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"
}