| title | plannerUser resource type |
|---|---|
| description | Provides access to Planner resources for a user. |
| ms.localizationpriority | medium |
| author | TarkanSevilmis |
| ms.subservice | planner |
| doc_type | resourcePageType |
| ms.date | 05/23/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Provides access to Planner resources for a user.
| Method | Return Type | Description |
|---|---|---|
| List user's assigned tasks | plannerTask collection | Get the plannerTasks assigned to the user. |
| List user's My Day tasks | plannerTask collection | Get the plannerTasks to be shown in the user's MyDay view. |
| List user's favorite plans | plannerPlan collection | Get the plannerPlans marked as favorite by the user. |
| List user's recent plans | plannerPlan collection | Get the plannerPlans recently viewed by the user. |
| List user's plans in rosters | plannerPlan collection | Get the plannerPlans contained by the plannerRosters that the user is a member. |
| Update user's settings | plannerUser | Update a plannerUser object. |
| Property | Type | Description |
|---|---|---|
| id | String | Read-only. Unique identifier for the plannerUser object. |
| favoritePlanReferences | plannerFavoritePlanReferenceCollection | A collection that contains the references to the plans that the user marked as favorites. |
| recentPlanReferences | plannerRecentPlanReferenceCollection | A collection that contains references to the plans that the user recently viewed in apps that support recent plans. |
| Relationship | Type | Description |
|---|---|---|
| favoritePlans | plannerPlan collection | Read-only. Nullable. Returns the plannerPlans that the user marked as favorites. |
| recentPlans | plannerPlan collection | Read-only. Nullable. Returns the plannerPlans that the user recently viewed in apps that support recent plans. |
| rosterPlans | plannerPlan collection | Read-only. Nullable. Returns the plannerPlans contained by the plannerRosters the user is a member. |
| tasks | plannerTask collection | Read-only. Nullable. Returns the plannerTasks assigned to the user. |
| myDayTasks | plannerTask collection | Read-only. Nullable. Returns the plannerTasks to be shown in the My Day view of the user. |
The following JSON representation shows the resource type.
{
"id": "String (identifier)",
"favoritePlanReferences": {"@odata.type": "microsoft.graph.plannerFavoritePlanReferenceCollection"},
"recentPlanReferences": {"@odata.type": "microsoft.graph.plannerRecentPlanReferenceCollection"}
}