Skip to content

Commit fdfa1e2

Browse files
authored
Merge pull request #26117 from microsoftgraph/freshness-OpenExtensionsTutorial
[Content-Freshness] Open extensions - users
2 parents 30dea7e + 5528683 commit fdfa1e2

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

concepts/extensibility-open-users.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
---
22
title: "Add custom data to users using open extensions"
3-
description: "Learn how to add an open extension to a user's profile, query it, change and delete the extension."
3+
description: "Learn how to use open extensions to add lightweight data to a user's profile, query it, change, and delete the extension."
44
author: FaithOmbongi
55
ms.author: ombongifaith
66
ms.reviewer: dkershaw
77
ms.subservice: extensions
88
ms.localizationpriority: high
99
ms.custom: graphiamtop20
1010
ms.topic: tutorial
11-
ms.date: 01/25/2024
11+
ms.date: 01/17/2025
1212
#Customer intent: As a developer, I want to learn how to store lightweight data to Microsoft Entra users through Microsoft Graph, and avoid using an external database system.
1313
---
1414

1515
# Add custom data to users using open extensions
1616

1717
In this tutorial, you lean how to use [open extensions](/graph/api/resources/opentypeextension).
1818

19-
Imagine you're building an application that's available on multiple client platforms, such as desktop and mobile. You want to let users configure their UI experience so it's consistent no matter which device they use to sign in to your app.
19+
Imagine you're building an application that's available on multiple client platforms, such as desktop and mobile. You want to the app's users to configure their UI experience so it's consistent no matter which device they use to sign in.
2020

2121
For this scenario, this article shows you how to:
2222

@@ -34,7 +34,7 @@ For this scenario, this article shows you how to:
3434

3535
To reproduce the steps in this article, you need the following privileges:
3636

37-
- Sign in to an API client such as [Graph Explorer](https://aka.ms/ge) and the user you want to store the roaming profile for.
37+
- Sign in to an API client such as [Graph Explorer](https://aka.ms/ge) as the user you want to store the roaming profile for.
3838
- Grant the app the *User.ReadWrite* delegated permission for the signed-in user.
3939

4040
## Step 1. Add roaming profile information
@@ -119,7 +119,7 @@ Content-Type: application/json
119119

120120
## Step 2. Retrieve roaming profile information
121121

122-
When the user signs in to the app from another device, the app calls Microsoft Graph to retrieve the user's profile details and expand the **extensions** navigation property to get their roaming settings, then uses this data to provide the same experience as on the other device.
122+
When the user signs in to the app from another device, the app calls Microsoft Graph to retrieve their profile details including the **extensions** navigation property that contains their roaming settings, then uses this data to provide the same experience as on the other device.
123123

124124
### Request
125125

@@ -202,7 +202,7 @@ Content-Type: application/json
202202

203203
The user can choose to change their roaming profile information. The app calls Microsoft Graph by running the following query. The request returns a `204 No Content` response code.
204204

205-
You must include all properties in the request body as well, even if you want to update only a subset of them. Otherwise, Microsoft Graph removes the properties you don't pass in. To delete data but keep a property, set the property value to `null`.
205+
You must include all properties in the request body, even if you want to update only a subset. Otherwise, Microsoft Graph removes the unspecified properties. To delete data but keep a property, set the property value to `null`.
206206

207207
# [HTTP](#tab/http)
208208
<!-- {
@@ -215,7 +215,7 @@ Content-type: application/json
215215
216216
{
217217
"theme":"light",
218-
"color":"yellow",
218+
"color":"purple",
219219
"lang":"Swahili"
220220
}
221221
```

0 commit comments

Comments
 (0)