RangeSort: apply
Namespace: microsoft.graph
Executa uma operação de classificação.
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) | Files.ReadWrite | Indisponível. |
Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
POST /me/drive/items/{id}/workbook/names/{name}/range/sort/apply
POST /me/drive/root:/{item-path}:/workbook/names/{name}/range/sort/apply
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>')/sort/apply
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')/sort/apply
POST /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range/sort/apply
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range/sort/apply
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
Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.
Parâmetro | Tipo | Descrição |
---|---|---|
campos | Coleção WorkbookSortField | A lista de condições para a classificação. |
matchCase | Booleano | Opcional. Se pretende que a caixa determine a ordenação de cadeias. |
hasHeaders | Booleano | Opcional. Se o intervalo tem um cabeçalho. |
orientation | string | Opcional. Se a operação classifica linhas ou colunas. Os valores possíveis são: Rows , Columns . |
method | string | Opcional. O método de ordenação usado pelos caracteres chineses. Os valores possíveis são: PinYin , StrokeCount . |
Resposta
Se bem sucedido, este método retorna um código de resposta 200 OK
. Não devolve nada no corpo da resposta.
Exemplo
Eis um exemplo de como chamar esta API.
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/sort/apply
Content-type: application/json
{
"fields": [
{
"key": 99,
"sortOn": "sortOn-value",
"ascending": true,
"color": "color-value",
"dataOption": "dataOption-value",
"icon": {
"set": "set-value",
"index": 99
}
}
],
"matchCase": true,
"hasHeaders": true,
"orientation": "orientation-value",
"method": "method-value"
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK