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