创建表

使用此 API 创建新的表。

先决条件

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

* Files.ReadWrite

HTTP 请求

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

请求标头

名称 说明
Authorization Bearer {token}。必需。

请求正文

在请求正文中,提供以下参数。

请求参数

名称 类型 说明
Address string 区域地址。若要从 worksheets/{id or name}/tables/add 路径调用此 API,地址中无需有工作表名称前缀。不过,若要从 workbook/tables/add 路径调用此 API,请提供需要在其中创建表的工作表名称(例如:sheet1!A1:D4
hasHeaders 布尔 指示区域是否具有列标签的布尔值。如果源不包含标头(即,当此属性设置为 false 时),Excel 将自动生成标头,数据将向下移动一行。

响应

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

示例

请求

下面是一个请求示例。

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

{
  "address": "A1:D8",
  "hasHeaders": false
}
响应

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

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

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