创建 tableRow

项目
01/12/2022

命名空间：microsoft.graph

重要

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

将行添加到表的末尾。

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

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

权限

要调用此 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	Bearer {token}。必需。
Content-Type	application/json. Required.
Prefer	respond-async。指示请求是异步请求。可选。
Workbook-Session-Id	{Workbook-Session-Id}。根据 createSession 请求创建。可选。

请求正文

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

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

响应

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

示例

示例 1：向表中添加两行

本示例中，在表格末尾插入两行数据。

请求

下面是一个请求示例。

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

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


const options = {
    authProvider,
};

const client = Client.init(options);

const workbookTableRow = {
  values: "[
    [1, 2, 3],
    [4, 5, 6]
  ]"
};

await client.api('/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows')
    .version('beta')
    .post(workbookTableRow);

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var workbookTableRow = new WorkbookTableRow
{
    Values = JsonDocument.Parse(@"""[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]""")
};

await graphClient.Me.Drive.Items["{driveItem-id}"].Workbook.Tables["{workbookTable-id}"].Rows
    .Request()
    .Header("Prefer","respond-async")
    .Header("Workbook-Session-Id","{Workbook-Session-Id}")
    .AddAsync(workbookTableRow);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"respond-async" forHTTPHeaderField:@"Prefer"];
[urlRequest setValue:@"{Workbook-Session-Id}" forHTTPHeaderField:@"Workbook-Session-Id"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphWorkbookTableRow *workbookTableRow = [[MSGraphWorkbookTableRow alloc] init];
[workbookTableRow setValues:@"[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]"];

NSError *error;
NSData *workbookTableRowData = [workbookTableRow getSerializedDataWithError:&error];
[urlRequest setHTTPBody:workbookTableRowData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

LinkedList<Option> requestOptions = new LinkedList<Option>();
requestOptions.add(new HeaderOption("Prefer", "respond-async"));
requestOptions.add(new HeaderOption("Workbook-Session-Id", "{Workbook-Session-Id}"));

WorkbookTableRow workbookTableRow = new WorkbookTableRow();
workbookTableRow.values = JsonParser.parseString("\"[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]\"");

graphClient.me().drive().items("01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ").workbook().tables("Table1").rows()
    .buildRequest( requestOptions )
    .post(workbookTableRow);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

下面是一个响应示例。

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

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

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

示例 2：异步向表中添加两行

如果请求所花的时间超过预期，异步请求将非常有用。请注意， Workbook-Session-Id 发出异步请求时需要标头。用户需要在使用异步富 API 功能之前创建会话。在 Prefer:respond-async 异步请求中，标头也是必需的。

对于异步功能，用户通常需要发出 2-3 个请求。此请求 Get workbookOperation 请求和（可选）获取 tableRowOperationResult 请求。

请求

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

POST https://graph.microsoft.com/beta/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]
  ]"
}

响应

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

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

{
}

创建 tableRow

权限

HTTP 请求

请求标头

请求正文

响应

示例

示例 1：向表中添加两行

请求

响应

示例 2：异步向表中添加两行

请求

响应

反馈