创建表

命名空间：microsoft.graph

使用此 API 创建新的表。

Permissions

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

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

HTTP 请求

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

请求标头

名称	说明
Authorization	Bearer {token}。必需。
Workbook-Session-Id	确定是否保留更改的工作簿会话 ID。可选。

请求正文

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

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

响应

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

示例

请求

下面是一个请求示例。

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

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

响应

这是一个示例响应。注意：为提高可读性，可能缩短了此处显示的响应对象。

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

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