workbook： tableRowOperationResult

命名空间：microsoft.graph

此函数是异步创建 workbookTableRow 资源的一系列步骤中的最后一个。

创建多个表行的最佳实践是在一个 create tableRow 操作中批处理这些行，并异步执行该操作。

创建表行的异步请求涉及以下步骤：

1. 发出异步创建 tableRow 请求并获取响应标头中返回的 Location 查询 URL。
2. 使用步骤 1 返回的查询 URL 发出 Get workbookOperation 请求并获取步骤 3 的操作 ID。 或者，为方便起见，在获取 operationStatus 结果后，可以从响应中返回的 succeeded workbookOperation的 resourceLocation 属性获取查询 URL，将查询 URL 应用到步骤 3。
3. 使用步骤 2 返回的查询 URL 作为此函数 tableRowOperationResult 的 GET 请求 URL。 成功的函数调用将返回 workbookTableRow 资源中的新表行。

如果单独调用此函数，则此函数不执行任何工作。

权限

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

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

HTTP 请求

GET /me/drive/items/{id}/workbook/tableRowOperationResult(key={operation-id})
GET /me/drive/root:/{item-path}:/workbook/tableRowOperationResult(key={operation-id})

函数参数

请求 URL 需要以下查询参数。

参数	类型	Description
Key	String	在上一个 Get workbookOperation请求中返回的 workbookOperation 响应中提供的 operationId。

请求标头

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

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此函数在响应 200 OK 正文中返回 响应代码和 workbookTableRow 对象。

示例

请求

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

HTTP

GET https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var workbookTableRow = await graphClient.Me.Drive.Items["{driveItem-id}"].Workbook
    .TableRowOperationResult("0195cfac-bd22-4f91-b276-dece0aa2378b")
    .Request()
    .GetAsync();

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

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

let workbookTableRow = await client.api('/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')')
    .version('beta')
    .get();

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

Objective-C

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/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')"]]];
[urlRequest setHTTPMethod:@"GET"];

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

        MSGraphWorkbookTableRow *workbookTableRow = [[MSGraphWorkbookTableRow alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

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

Java

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

WorkbookTableRow workbookTableRow = graphClient.me().drive().items("01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ").workbook()
    .tableRowOperationResult(WorkbookTableRowOperationResultParameterSet
        .newBuilder()
        .withKey("0195cfac-bd22-4f91-b276-dece0aa2378b")
        .build())
    .buildRequest()
    .get();

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

响应

下面展示了示例响应。

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

HTTP/1.1 200 OK
Content-Type: application/json

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