工作簿:tableRowOperationResult

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

此函数是异步创建 workbookTableRow 资源的一系列步骤中的最后一个。

创建多个表行的最佳做法是在一个 create tableRow 操作中对其进行批处理,并异步执行操作。

创建表行的异步请求涉及以下步骤:

  1. 发出异步 Create tableRow 请求,并获取响应标头中返回的 Location 查询 URL。
  2. 使用从步骤 1 返回的查询 URL 发出 获取 workbookOperation 请求,并获取步骤 3 的操作 ID。 或者,为方便起见,在获取 succeededoperationStatus 结果后,可以从响应中返回的 workbookOperationresourceLocation 属性获取查询 URL,并将查询 URL 应用于步骤 3。
  3. 使用从步骤 2 返回的查询 URL 作为此函数 tableRowOperationResult 的 GET 请求 URL。 成功的函数调用将返回 workbookTableRow 资源中的新表行。

如果单独调用,此函数不会执行任何操作。

此 API 可用于以下国家级云部署

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国

权限

要调用此 API,需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Files.ReadWrite
委派(个人 Microsoft 帐户) 不支持。
应用程序 不支持。

HTTP 请求

GET /me/drive/items/{id}/workbook/tableRowOperationResult(key={operation-id})
GET /me/drive/root:/{item-path}:/workbook/tableRowOperationResult(key={operation-id})

函数参数

请求 URL 需要以下查询参数。

参数 类型 说明
注册表项 String 在前面的 Get workbookOperation 请求中返回的 workbookOperation 响应中提供的 operationId

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权
Workbook-Session-Id 确定是否保留更改的工作簿会话 ID。 可选。

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此函数在响应正文中返回响应 200 OK 代码和 workbookTableRow 对象。

示例

请求

以下示例显示了一个请求。

GET https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')

响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "index": 99,
  "values": "[[1, 2, 3]]"
}