Obter workbookOperation
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.
Sem sentido se essa url for chamada de forma independente. Essa solicitação faz parte de todas as solicitações assíncronas do Excel. Isso é usado para recuperar o status de um objeto workbookOperation.
Atualmente, nem todas as solicitações dão suporte a assíncronas. Veja Criar solicitação de sessão como exemplo.
Emita uma solicitação de sessão criar assíncrona, siga a documentação e você pode obter status código 202 Accepted
, a operação assíncrona começa a partir daqui e você pode encontrar a url necessária do cabeçalho de resposta da parte de localização.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
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 de sessão de pasta de trabalho que determina se as alterações são persistentes ou não. Opcional. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e o objeto workbookOperation solicitado no corpo da resposta.
Exemplos
Solicitação
A seguir está um exemplo de uma solicitação de operação de execução longa.
GET https://graph.microsoft.com/beta/me/drive/items/{drive-item-id}/workbook/operations/{operation-id}
Resposta
Resposta em execução
A seguir está a resposta com o status de running
. Quando você receber essa status, pesquise a solicitação 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
A seguir está a resposta com o status de succeeded
. O resourceLocation é um grupo de URLs que representam os valores retornados da operação de longa execução original. Consulte o seguinte para obter detalhes sobre como obter o resultado da propriedade resourceLocation .
Operação | Resourcelocation |
---|---|
Criar sessão | sessionInfoResource |
Criar tableRow | tableRowOperationResult |
Excluir tableRow | Nenhum recursoLocation necessário. |
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0195cfac-bd22-4f91-b276-dece0aa2378b",
"status": "succeeded",
"resourceLocation":"https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/sessionInfoResource(key='0195cfac-bd22-4f91-b276-dece0aa2378b')?sessionId=Y2x1c3Rlcj1QU0c0JnNlc3Npb249MTUuU0cyUEVQRjAwMDI4RjI1MS5BMTE2LjEuVTM2LmM4MGRiNjkwLTQwMTktNGNkNS1hYWJiLTJmYzczM2YxZTQ5ZjE0LjUuZW4tVVM1LmVuLVVTMjQuMTAwM2JmZmRhYzUyMzkzOS1Qcml2YXRlMS5TMjQuJTJmUEI0JTJmWjJqZmt1aXhJZHBjeE8xYmclM2QlM2QxNi4xNi4wLjE0NDEwLjM1MDUwMTQuNS5lbi1VUzUuZW4tVVMxLk0xLk4wLjEuUyZ1c2lkPWExOTMyNTU0LTlhNDAtNzYzNi1mNDU3LWEyNjExMmFkNDg2YQ=="
}
Falha na resposta
A seguir está 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."
}
}
}
}