yang1276的博客

Microsoft Graph API 的/children端点$filter。

你的需求推荐我要找一份 Word/PDF/Excel 文件driveItem我要找 OneDrive 里的照片或文档driveItem我要找任务列表里的某条任务listItem我要找自定义业务列表里的记录listItem我不确定，我想搜全站所有内容同时传入指定具体的通常比不指定（或搜索所有类型）性能更好，相关性更高。如果你明确知道用户在找文件，只传driveItem可以减少噪音并加快响应速度。entityTypes 可以只指定文件吗可以。你可以将只指定为来专门搜索文件。

**Item ID**: 是文件夹在 Drive 中的 ID。* *提示*：如果不确定 ID，可以先调用 `/children` 不带 filter 参数，打印出返回的 `id` 和 `name` 来确认。建议优先使用 **方法一 (SDK)**，因为它能帮你处理很多底层的细节（如分页 `@odata.nextLink`、Token 自动刷新等）。4. **API 权限**：确保应用注册中添加了 `Files.Read` 或 `Sites.Read.All` 权限，并授予了管理员同意。

优化项建议操作影响程度移除，除非必须用于筛选统计⭐⭐⭐⭐⭐ (极高)限制为单一类型 (如driveItem⭐⭐⭐⭐Fields只选idtitlewebUrl⭐⭐⭐Size限制在 25-50 以内⭐⭐Network服务端调用尽量靠近 Azure 节点⭐⭐⭐Throttling实现 429 重试机制⭐⭐⭐最可能的快速修复方案：检查你的 Request Body，去掉并限制为单一类型，通常能解决 80% 的慢查询问题。

filter=lastModifiedDateTime%20ge%202025-02-27T15%3A05%3A58.000Z%20and%20file%20ne%20null 不加filter没问题，加了filter报错：{"code":"invalidRequest","message":"Invalid request"}System.out.println("=== 过滤后的文件 ===");| **最可靠方案** | Search API (`/search/query`) |

**标准 UTC 时间** | `2025-02-27T15:05:58Z` | `datetime'2025-02-27T15:05:58Z'` | Graph API 不需要 `datetime` 前缀和单引号 || **带时区偏移** | `2025-02-27T15:05:58+08:00` | `2025-02-27T15:05:58` | 缺少时区标识 (`Z` 或 `+xx:xx`) |System.out.println("状态码：" + response.statusCode());

**400 Bad Request** | `The field 'lastModifiedDateTime' does not exist` | 在 REST API 中用了 Graph 的字段名 | 将 `lastModifiedDateTime` 改为 **`Modified`** || **字段名称** | `lastModifiedDateTime` | **`Modified`** (列表项) <br> **`TimeLastModified`** (文件对象) |

**解决方案：** 确保“修改时间”列在 SharePoint 列表设置中建立了**索引 (Indexed Column)**。简单直接的回答是：**支持**，但具体取决于你使用的是 **Microsoft Graph API** 还是传统的 **SharePoint REST API**，且字段名称和语法略有不同。* **Graph API** 强制使用 **UTC 时间** (末尾带 `Z`)。* 如果是 **ListItem** (列表项)：字段通常是 `Modified`。

注册成功后，在 **概述 (Overview)** 页面，复制 **应用程序 (客户端) ID (Application (client) ID)**。2. 导航到 **标识 (Identity)** -> **应用程序 (Applications)** -> **应用注册 (App registrations)**。2. 在左侧菜单选择 **标识 (Identity)** -> **概述 (Overview)** -> **租户属性 (Tenant properties)**。

在 SharePoint 中创建站点主要有三种方式：**Microsoft Graph API（开发推荐）**、** SharePoint 管理中心/界面（手动）** 和 **PowerShell（管理员推荐）**。| **权限传播** | 创建站点后，记得将需要访问的用户添加到站点的 **成员 (Members)** 或 **访客 (Visitors)** 组。* **Graph API 限制**：标准的 `POST /sites` 通常会在租户的**默认地理区域**创建站点。

当你使用 **应用程序权限 (Application Permissions)**（即 Client Credentials Flow，没有用户上下文）调用 `search/query` 接口时，Microsoft 出于 **数据 residency（数据驻留）** 和 **多地理位置 (Multi-Geo)** 合规性的考虑，强制要求你在请求体中明确指定搜索的 **地理区域 (Region)**。* **权限**：需要 `Sites.Read.All` 或 `Sites.Search.All`。

本文将介绍如何从 SharePoint 文档库加载文档，并提供相关的技术细节和代码示例，以帮助开发者轻松实现这一过程。Document Library ID: 使用 Graph Explorer Playground 进行请求 https://graph.microsoft.com/v1.0/sites/<SharePoint site ID>/drive 来获取。通过本文，你了解了如何使用 SharePointLoader 轻松从 SharePoint 文档库加载文档。2. 获取必要的 ID 信息。

lookup字段（city为lookup表）示例：weburl/_api/web/lists/getbytitle('list name')/items?select=ID,Title,city/Id&person字段（Author为用户字段）示例：weburl/_api/web/lists/getbytitle('list name')/items?select=Author/Title&示例：weburl/_api/web/lists/getbytitle('list name')/items?

*driveId** 和 **ListId** 之间**没有直接的字符串转换公式**（不能通过简单的编码/解码互相转换），因为它们属于不同的 API 体系（Microsoft Graph vs SharePoint REST），且格式不同。* **为什么不推荐手动解码？手动解析容易导致错误。| **ListId → driveId** | **Graph API** | `GET /sites/{site-id}/lists/{list-id}/drive` (取响应中的 `id`) |

*不能直接仅通过 Drive Name 唯一获取 ListId**，因为 Drive Name（例如 "Documents"）在租户中**不是唯一**的（多个 Site 都可以有名为 "Documents" 的文档库）。**建议优先使用内部名称或确保语言匹配。3. **转换 ListId**: 调用 `GET /drives/{drive-id}/list`，响应中的 `id` 即为 **ListId**。* **优点**: 直接返回 List 对象，其中的 `id` 就是 **ListId**。

例如，一个简单的KQL查询可以是简单的关键词，如 searchBoxQuery:servers ，其中 searchBoxQuery 是系统预留的变量，代表用户在搜索框中输入的内容。在本章节中，我们详细探讨了SharePoint REST Search API中查询表达式的使用，包括KQL语法的介绍和表达式中的特殊字符处理，以及如何使用范围查询和多字段匹配技术来实现更精确和有优先级的搜索。在SharePoint REST搜索API中，要实现复杂的查询逻辑，就需要组合不同的查询参数。以上是第三章的核心内容。

无论是 **Microsoft Graph Search API** 还是 **SharePoint REST Search API**，`ListId` 都是一个**可管理属性（Managed Property）**。即使用户在查询中指定了多个 `ListId`，如果该用户**没有权限访问其中某个 List**，该 List 中的内容不会出现在结果中，且不会报错。**支持多个**，请使用 **`OR`** 语法在查询字符串中组合，例如：`(ListId:'id1' OR ListId:'id2')`。

在SharePoint中，如果你想通过URL来过滤日期，你可以通过查询字符串（Query String）来实现。SharePoint支持使用CAML（Collaborative Application Markup Language）查询或REST API来过滤列表或库中的数据。下面是如何通过URL来过滤日期的具体步骤：使用查询字符串1. 确定你的视图：首先，确保你知道你想要过滤的视图（View）的名称。2. 构造URL：你可以在SharePoint列表或库的URL后面添加查询字符串来过滤日期。

但是，根据你的具体使用场景（是使用 **Microsoft Graph Search API** 还是 **Drive Items API**），有几种标准的**替代方案**可以实现“检索多个指定 Drive 中的内容”。| **经典 SharePoint 环境** | **KQL `ListId`** | 使用 `ListId` 代替 `DriveId` 进行 `OR` 查询。* **如何支持多个**：同样需要使用上述的 **Batch 请求**，或者在客户端代码中循环调用（性能较差）。