使用Microsoft Graph按索引获取Excel表格行返回400 API未找到求助

核心问题：混淆了Graph行ID与Excel行索引 #

你遇到的400错误，本质是对文档中“行索引”的理解偏差——Graph API文档里的{row-id}指的是Graph分配给表格行的唯一ID，而非Excel工作表里的行号（比如第2行这种直观索引）。直接用Excel行号作为URL路径参数，会导致API无法匹配到对应的资源，从而返回400错误。

两种正确获取单行的方式 #

方式1：通过Graph行ID获取 #

1. 先调用批量获取行的接口（你已能正常使用的.../rows），拿到目标行的id字段值（这是Graph生成的字符串或数字标识）
2. 构造正确的请求URL：

https://graph.microsoft.com/v1.0/sites/{site_id}/drives/{drive_id}/items/{item_id}/workbook/worksheets/{worksheet_id}/tables/{table_id}/rows/{graph_row_id}

3. 发起GET请求即可获取对应单行数据

方式2：通过Excel行索引筛选获取 #

如果需要直接用Excel里的行号（比如第3行）获取，不要在URL路径后追加索引，而是用$filter参数筛选index属性（该属性对应Excel的行索引，从1开始计数）：

https://graph.microsoft.com/v1.0/sites/{site_id}/drives/{drive_id}/items/{item_id}/workbook/worksheets/{worksheet_id}/tables/{table_id}/rows?$filter=index eq {excel_row_index}

比如要获取第2行，就用$filter=index eq 2

额外排查点 #

• 确认目标行属于结构化表格：/tables/{table_id}/rows仅针对Excel中插入的结构化表格（不是普通单元格区域），如果是普通区域，需要改用/workbook/worksheets/{id}/range接口
• 检查权限：虽然批量获取正常，但确保你的应用已拥有Files.Read或更高权限（避免个别接口权限限制）
• 验证行索引有效性：确保你使用的Excel行索引在表格的实际范围内（表格的行是连续的，超出表格范围的行无法通过tableRow接口获取）

关于文档的说明 #

该功能是已正式上线的，文档中的“行索引”指的是Graph自身的行资源ID，并非Excel的行号——文档描述确实存在一定歧义，但你可以通过查看接口返回的tableRow对象结构，找到id和index两个字段的区别，就能理解正确的用法。

内容的提问来源于stack exchange，提问作者michal.kyjovsky