|
1 | 1 | ---
|
2 | 2 | title: "Get incremental changes for users"
|
3 |
| -description: "Use delta query to discover changes without fetching the entire set of users to compare changes. Example shows a series of requests to track changes to users." |
| 3 | +description: "Learn how to use delta query in Microsoft Graph to discover changes without fetching the entire set of users to compare changes." |
4 | 4 | author: FaithOmbongi
|
5 | 5 | ms.author: ombongifaith
|
6 | 6 | ms.reviewer: keylimesoda
|
7 | 7 | ms.topic: tutorial
|
8 | 8 | ms.subservice: change-notifications
|
9 | 9 | ms.localizationpriority: high
|
10 | 10 | ms.custom: graphiamtop20
|
11 |
| -ms.date: 01/12/2024 |
| 11 | +ms.date: 01/15/2025 |
12 | 12 | #customer intent: As a developer, I want to track changes to users, so that I can build apps that process the changes according to the business requirements.
|
13 | 13 | ---
|
14 | 14 |
|
@@ -44,9 +44,10 @@ To track changes in the user resource, make a request and include the **delta**
|
44 | 44 |
|
45 | 45 | Take note of the following items:
|
46 | 46 |
|
47 |
| -- The optional `$select` query parameter is included in the request to demonstrate how query parameters are automatically included in future requests. If required, query parameters must be specified in the initial request. |
| 47 | +- The optional `$select` query parameter is included in the request to demonstrate how query parameters are automatically included in future requests. If you want to use query parameters to control how much data is returned, you must include them in the initial request. |
48 | 48 | - Only properties included in `$select` are tracked for changes. If `$select` isn't specified, all properties of the object are tracked for changes.
|
49 | 49 | - The initial request doesn't include a state token. State tokens are used in subsequent requests.
|
| 50 | +- Subsequent requests can't be modified. |
50 | 51 | - [Limitations of query parameters in delta functions](delta-query-overview.md#optional-query-parameters).
|
51 | 52 |
|
52 | 53 | # [HTTP](#tab/http)
|
@@ -94,7 +95,7 @@ GET https://graph.microsoft.com/v1.0/users/delta?$select=displayName,givenName,s
|
94 | 95 |
|
95 | 96 | ### Initial response
|
96 | 97 |
|
97 |
| -If successful, this method returns `200 OK` response code and [user](/graph/api/resources/user) collection object in the response body. Assuming the entire set of users is too large, the response includes a `@odata.nextLink` state token in an `@odata.nextLink` parameter. |
| 98 | +If successful, this method returns `200 OK` response code and [user](/graph/api/resources/user) collection object in the response body. If the entire set of users is too large, the response includes a `@odata.nextLink` state token in an `@odata.nextLink` parameter. |
98 | 99 |
|
99 | 100 | In this example, a `@odata.nextLink` URL is returned indicating there are more pages of data to be retrieved in the session. Notice the `$skiptoken` in the URL. The `$select` query parameter from the initial request is encoded into the `@odata.nextLink` URL.
|
100 | 101 |
|
|
0 commit comments