workbook: tableRowOperationResult

Namespace: microsoft.graph

Esta função é a última de uma série de etapas para criar um recurso workbookTableRow de forma assíncrona.

Uma prática prática para criar várias linhas de tabela é em lotá-las em lotes em uma operação de criação de tableRow e realizar a operação de forma assíncrona.

Uma solicitação assíncrona para criar linhas de tabela envolve as seguintes etapas:

1. Emitir uma solicitação Criar tableRow assíncrona e obter a URL de consulta retornada no Location header de resposta.
2. Use a URL de consulta retornada da etapa 1 para emitir a solicitação Get workbookOperation e obter a ID da operação para a etapa 3. Como alternativa, por conveniência, depois de obter um resultado operationStatus, você pode obter a URL de consulta da succeeded propriedade resourceLocation da workbookOperation retornada na resposta e aplicar a URL de consulta à etapa 3.
3. Use a URL de consulta retornada da etapa 2 como a URL de solicitação GET para esta função tableRowOperationResult. Uma chamada de função bem-sucedida retorna as novas linhas de tabela em um recurso workbookTableRow.

Essa função não fará nada se for chamada independentemente.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Files.ReadWrite
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Sem suporte.

Solicitação HTTP

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

Parâmetros de função

A URL de solicitação requer o parâmetro de consulta a seguir.

Parâmetro	Tipo	Descrição
key	Cadeia de caracteres	A operationId fornecida na resposta workbookOperation retornada na solicitação Get workbookOperation anterior.

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório.
Workbook-Session-Id	ID da sessão da workbook que determina se as alterações são persistentes. Opcional.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se tiver êxito, essa função retornará um código de resposta e um 200 OK objeto workbookTableRow no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do 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();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do 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];

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do 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();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

Resposta

Este é um exemplo de resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

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