Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Sem sentido se este URL for chamado de forma independente. Este pedido faz parte de todos os pedidos assíncrono para o Excel. Isto é utilizado para obter a status de um objeto workbookOperation.
Atualmente, nem todos os pedidos suportam assíncrona. Veja Criar pedido de sessão como exemplo.
Emita um pedido de sessão de Criação assíncrona, siga a documentação e poderá obter status código 202 Accepted, a operação assíncrona começa a partir daqui e pode encontrar o URL necessário para este documento no cabeçalho da resposta, a partir da parte da localização.
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/operations/{operation-id}
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-sucedido, este método devolve um 200 OK código de resposta e o objeto workbookOperation pedido no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/me/drive/items/{drive-item-id}/workbook/operations/{operation-id}
Resposta
Resposta em execução
Segue-se a resposta com o status de running. Quando receber este status, consulte o pedido novamente até não obter as mesmas respostas.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0195cfac-bd22-4f91-b276-dece0aa2378b",
"status": "running"
}
Resposta bem-sucedida
Segue-se a resposta com o status de succeeded. ResourceLocation é um grupo de URLs que representam os valores devolvidos da operação de execução prolongada original. Veja a tabela seguinte para obter detalhes sobre como obter o resultado da propriedade resourceLocation .
| Operação | resourceLocation |
|---|---|
| Criar sessão | sessionInfoResource |
| Criar tableRow | tableRowOperationResult |
| Eliminar tabelaRow | Não é necessário resourceLocation. |
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0195cfac-bd22-4f91-b276-dece0aa2378b",
"status": "succeeded",
"resourceLocation":"https://graph.microsoft.com/v1.0/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/sessionInfoResource(key='0195cfac-bd22-4f91-b276-dece0aa2378b')?sessionId=Y2x1c3Rlcj1QU0c0JnNlc3Npb249MTUuU0cyUEVQRjAwMDI4RjI1MS5BMTE2LjEuVTM2LmM4MGRiNjkwLTQwMTktNGNkNS1hYWJiLTJmYzczM2YxZTQ5ZjE0LjUuZW4tVVM1LmVuLVVTMjQuMTAwM2JmZmRhYzUyMzkzOS1Qcml2YXRlMS5TMjQuJTJmUEI0JTJmWjJqZmt1aXhJZHBjeE8xYmclM2QlM2QxNi4xNi4wLjE0NDEwLjM1MDUwMTQuNS5lbi1VUzUuZW4tVVMxLk0xLk4wLjEuUyZ1c2lkPWExOTMyNTU0LTlhNDAtNzYzNi1mNDU3LWEyNjExMmFkNDg2YQ=="
}
A resposta falhou
Segue-se a resposta com o status de failed.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0195cfac-bd22-4f91-b276-dece0aa2378b",
"status": "failed",
"error":
{
"code": "internalServerError",
"message": "An internal server error occurred while processing the request.",
"innerError": {
"code": ""internalServerErrorUncategorized",
"message": "An unspecified error has occurred.",
"innerError": {
"code": "GenericFileOpenError",
"message": "The workbook cannot be opened."
}
}
}
}