创建 TableRow

命名空间:microsoft.graph

将行添加到表的末尾。

请注意,此 API 可以接受多行数据。 一次添加一行可能会影响性能。 建议的方法是在单个调用中对行批处理在一起,而不是插入单行。 为了获得最佳结果,请在应用程序端收集要插入的行并执行单行添加操作。 试验行数以确定要在单个 API 调用中使用的理想行数。

此请求有时可能会导致错误 504 HTTP 。 此错误的适当响应做法是重复发出请求。

API 可用性

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

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

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。

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

HTTP 请求

POST /me/drive/items/{id}/workbook/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/rows
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/rows

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。
Prefer respond-async. 指示请求是异步请求。 可选。
Workbook-Session-Id {workbook-session-id}。 从 createSession 请求创建。 可选。

请求正文

在请求正文中,提供具有以下参数的 JSON 对象。

参数 类型 说明
index Int32 可选。 指定新行的相对位置。 如果为空,将在末尾进行添加。 插入的行下方的任何行将向下移动。 从零开始编制索引。
值 Json 表行的未格式化值的二维数组。

响应

如果成功,此方法将在响应正文中返回 201 Created 响应代码和 workbookTableRow 对象。

示例

示例 1:向表格添加两行

在本示例中,在表的末尾插入了两行数据。

请求

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

POST https://graph.microsoft.com/v1.0/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows
Content-type: application/json

{
  "values": [
    [1, 2, 3],
    [4, 5, 6]
  ]
}

响应

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

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

HTTP/1.1 201 Created
Content-type: application/json

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

示例 2:异步向表添加两行

如果请求花费的时间比预期时间长,异步请求将很有用。 请注意, Workbook-Session-Id 发出异步请求时需要标头。 用户需要先 创建会话 ,然后才能使用异步丰富的 API 功能。 异步请求中也需要标头 Prefer:respond-async 。

对于异步功能,用户通常需要发出两个或三个请求:此请求、 Get workbookOperation 和(可选)Get tableRowOperationResult。

请求

下面是异步请求的示例。 请注意,仅当请求需要很长时间才能响应时才会发生这种情况 202 Accepted 。 如果请求快速完成,它将像常规同步请求一样工作,回退到 示例 1。

POST https://graph.microsoft.com/v1.0/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows
Content-type: application/json
Prefer: respond-async
Workbook-Session-Id: {Workbook-Session-Id}

{
  "values": [
    [1, 2, 3],
    [4, 5, 6]
  ]
}

响应

下面是将导致异步操作的响应的另一个示例。 有关详细信息,请参阅 Get workbookOperation 和 Get tableRowOperationResult。

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/operations/0195cfac-bd22-4f91-b276-dece0aa2378b?sessionId=Y2x1c3Rlcj1QU0c0JnNlc3Npb249MTUuU0cyUEVQRjAwMDI4RjI1MS5BMTE2LjEuVTM2LmM4MGRiNjkwLTQwMTktNGNkNS1hYWJiLTJmYzczM2YxZTQ5ZjE0LjUuZW4tVVM1LmVuLVVTMjQuMTAwM2JmZmRhYzUyMzkzOS1Qcml2YXRlMS5TMjQuJTJmUEI0JTJmWjJqZmt1aXhJZHBjeE8xYmclM2QlM2QxNi4xNi4wLjE0NDEwLjM1MDUwMTQuNS5lbi1VUzUuZW4tVVMxLk0xLk4wLjEuUyZ1c2lkPWExOTMyNTU0LTlhNDAtNzYzNi1mNDU3LWEyNjExMmFkNDg2YQ==
Content-type: application/json

{
}