todoTaskList： delta
命名空间：microsoft.graph
获取一组已在待办Microsoft中添加、删除或删除的 todoTaskList 资源。
todoTaskList 的 delta 函数调用类似于 GET 请求，只是通过在一个或多个调用中适当应用状态令牌，可以查询 todoTaskList 中的增量更改。 这使你可以维护和同步用户的 todoTaskList 的本地存储，而无需每次从服务器提取所有 todoTaskList 。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派（工作或学校帐户） | Tasks.ReadWrite | 不可用。 |
| 委派（个人 Microsoft 帐户） | Tasks.ReadWrite | 不可用。 |
| 应用程序 | Tasks.Read.All | Tasks.ReadWrite.All |
HTTP 请求
GET /me/todo/lists/delta
GET /users/{id|userPrincipalName}/todo/lists/delta
查询参数
跟踪 todoTaskList 资源 中的更改会导致一轮或多次 增量 函数调用。 如果要使用任意查询参数（$deltatoken 和 $skiptoken 除外），则必须在最初的 delta 请求中指定它。 Microsoft Graph 自动将指定的任意参数编码为响应中提供的 @odata.nextLink 或 @odata.deltaLink URL 的令牌部分。
只需预先指定所需的任何查询参数一次。
在后续请求中，只需复制并应用 @odata.nextLink 上一响应中的 或 @odata.deltaLink URL，因为该 URL 已包含编码的所需参数。
| 查询参数 | 类型 | 说明 |
|---|---|---|
| $deltatoken | string | 在上一个 delta 函数的 URL 中@odata.deltaLink返回的状态令牌调用同一 todoTaskList 集合，指示完成这一轮更改跟踪。 将此令牌包含在对该集合的下一组更改追踪的首次请求中，并保存和应用整个 @odata.deltaLink URL。 |
| $skiptoken | string | 在上一个 delta 函数调用的 URL 中@odata.nextLink返回的状态令牌，指示在同一 todoTaskList 集合中要跟踪进一步的更改。 |
OData 查询参数
像在任何 GET 请求中一样，你可以使用 $select 查询参数以仅指定获取最佳性能所需的属性。 始终返回 id 属性。
请求标头
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| Content-Type | string | application/json. 必需。 |
| Prefer | string | odata.maxpagesize={x}。 可选。 |
响应
如果成功，此方法在响应正文中返回响应 200 OK 代码和 todoTaskList 集合对象。
示例
请求
以下示例演示如何进行初始 增量 函数调用，并将响应正文中 todoTaskList 的最大数目限制为 2。
若要跟踪 todoTaskList 中的更改，应使用适当的状态令牌进行一个或多个 delta 函数调用，以获取自上次增量查询以来的增量更改集。
跟踪 todoTaskList 和跟踪列表中的 todoTask 资源之间的主要区别在于增量查询请求 URL，以及返回 todoTaskList 而不是 todoTask 集合的 查询响应。
GET https://graph.microsoft.com/v1.0/me/todo/lists/delta
响应
如果请求成功，响应将包含一个状态令牌，其为 skipToken
(@odata.nextLink 响应标头) 或 @odata.deltaLink 响应标头) 中的 deltaToken (。
它们分别指示是应继续执行回合，还是已完成获取该回合的所有更改。
以下响应显示了 @odata.nextLink 响应头中的 skipToken。
注意：为了提高可读性，可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.deltaLink":"https://graph.microsoft.com/v1.0/me/todo/lists/delta?$skiptoken=ldfdgdgfoT5csv4k99nvQqyku0jaGqMhc6XyFff5qQTQ7RJOr",
"value": [
{
"@odata.etag":"W/\"4rfRVIPi9EqXgDbc8U7HGwADLLQ93w==\"",
"displayName":"List1",
"isOwner":true,
"isShared":false,
"wellknownListName":"none",
"id":"AQMkADMwNTcyZjQzLTdkMGItNDdjMy04ZTYwLTJhYmUzNGI5ZD"
}
]
}