TableCollection: add

创建一个新表。区域源地址确定将在其下添加表的工作表。如果无法添加表(例如,由于地址无效,或者表与另一个表重叠),将抛出错误。

先决条件

要执行此 API,需要以下范围

* Files.ReadWrite

HTTP 请求

POST /workbook/tables/add
POST /workbook/worksheets/{id|name}/tables/add

请求标头

名称 说明
Authorization Bearer {code}

请求正文

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

参数 类型 说明
address string 表示数据源的 range 对象的地址或名称。如果该地址不包含工作表名称,则使用当前活动的工作表。
hasHeaders boolean 指示导入的数据是否具有列标签的布尔值。如果源不包含标头(即,当此属性设置为 false 时),Excel 将自动生成标头,数据将向下移动一行。

响应

如果成功,此方法在响应正文中返回 200, OK 响应代码和 Table 对象。

示例

下面是一个如何调用此 API 的示例。

请求

下面是一个请求示例。

POST https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/tables/add
Content-type: application/json
Content-length: 54

{
  "address": "Sheet1!A1:D5",
  "hasHeaders": true
}
响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 109

{
  "id": "99",
  "name": "name-value",
  "showHeaders": true,
  "showTotals": true,
  "style": "style-value"
}