Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents your working hours and location preferences for modern hybrid work scenarios.
Work hours and location information are useful in scenarios that involve planning in-office days with colleagues and scheduling meetings across different working hours and time zones. You can get and update your work hours and locations as part of your personal work planning. Use these APIs to set different work locations and schedules to accommodate your flexible work arrangements.
Methods
| Method | Return Type | Description |
|---|---|---|
| Get | workHoursAndLocationsSetting | Get the properties and relationships of your own workHoursAndLocationsSetting. |
| Update | workHoursAndLocationsSetting | Update the properties of your own workHoursAndLocationsSetting. |
| Occurrences view | workPlanOccurrence collection | Get work plan occurrences from your own work plan within a specified date range. |
| List recurrences | workPlanRecurrence collection | Get the recurrences from your own work plan via the recurrences navigation property. |
| Create recurrence | workPlanRecurrence | Create a new workPlanRecurrence object in your own work plan. |
| Create occurrence | workPlanOccurrence | Create a new workPlanOccurrence object in your own work plan. |
Properties
| Property | Type | Description |
|---|---|---|
| maxSharedWorkLocationDetails | maxWorkLocationDetails | Controls the level of work location details that can be shared with colleagues. The possible values are: unknown, none, approximate, specific, unknownFutureValue. |
maxWorkLocationDetails values
| Member | Description |
|---|---|
| unknown | The level of location details to share is unknown. This value exists for backward compatibility only and can't be set as a new value. |
| none | No location details are shared. |
| approximate | Only general work location type is shared, such as office or remote. |
| specific | Detailed location information is shared, such as building and desk information. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| occurrences | workPlanOccurrence collection | Collection of work plan occurrences. |
| recurrences | workPlanRecurrence collection | Collection of recurring work plans defined by the user. |
JSON representation
The following JSON representation shows the resource type.
{
"maxSharedWorkLocationDetails": "String"
}