livro: tableRowOperationResult
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Esta função é a última de uma série de passos para criar recursos workbookTableRow de forma assíncrona.
Uma melhor prática para criar múltiplas linhas de tabela é criá-las em lote numa operação criar tableRow e executar a operação de forma assíncrona.
Um pedido assíncrono para criar linhas de tabela envolve os seguintes passos:
- Emita um pedido assíncrono Criar tableRow e obtenha o URL da consulta devolvido no cabeçalho da
Location
resposta. - Utilize o URL de consulta devolvido do passo 1 para emitir o pedido Get workbookOperation e obter o ID da operação para o passo 3.
Em alternativa, para sua comodidade, depois de obter um
succeeded
resultado operationStatus, pode obter o URL da consulta a partir da propriedade resourceLocation do livroOperação devolvida na resposta e aplicar o URL da consulta ao passo 3. - Utilize o URL de consulta devolvido do passo 2 como o URL do pedido GET para esta função tableRowOperationResult. Uma chamada de função com êxito devolve as novas linhas de tabela num recurso workbookTableRow .
Esta função não faz nada se for chamada de forma independente.
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Uma das seguintes permissões é necessá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
O URL do pedido requer o seguinte parâmetro de consulta.
Parâmetro | Tipo | Descrição |
---|---|---|
chave | Cadeia de caracteres | O operationId fornecido na resposta workbookOperation devolvida num pedido Get workbookOperation anterior. |
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Workbook-Session-Id | ID da sessão do livro 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 for bem-sucedida, esta função devolve um 200 OK
código de resposta e um objeto workbookTableRow no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')
Resposta
O exemplo a seguir mostra a 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]]"
}