livro: tableRowOperationResult
Namespace: microsoft.graph
Esta função é a última de uma série de passos para criar um recurso 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
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | Files.ReadWrite | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | 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 no 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]]"
}