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
Obter todos os descendentes de um tipo específico num local.
Observação
- Antes de poder utilizar esta API, certifique-se de que as definições de Places estão configuradas corretamente. Para obter mais informações, veja Pré-requisitos para Places lista e APIs descendentes.
- Este método não pode devolver mais de 2500 locais.
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) | Place.Read.All | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | Place.Read.All | Indisponível. |
Solicitação HTTP
GET /places/{id}/descendants/{placeType}
Nota:
{placeType}pode ser qualquer tipo de local suportado, comomicrosoft.graph.building,microsoft.graph.floor,microsoft.graph.section,microsoft.graph.room,microsoft.graph.workspaceemicrosoft.graph.desk.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
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 uma coleção de locais no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/places/ca163ae1-14a3-4e2a-8a97-5f82d672186f/descendants/microsoft.graph.desk
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
{
"value": [
{
"id": "530f7900-8063-4daf-9cc1-168cb3ac26e9",
"placeId": "530f7900-8063-4daf-9cc1-168cb3ac26e9",
"displayName": "desk 5",
"parentId": "ca163ae1-14a3-4e2a-8a97-5f82d672186f",
"isWheelChairAccessible": false,
"mode": { "@odata.type": "#microsoft.graph.dropInPlaceMode" }
},
{
"id": "57289959-4add-4270-872b-cc93ca099ce5",
"placeId": "57289959-4add-4270-872b-cc93ca099ce5",
"displayName": "desk 6",
"parentId": "ca163ae1-14a3-4e2a-8a97-5f82d672186f",
"isWheelChairAccessible": true,
"mailboxDetails": {
"externalDirectoryObjectId": "6abaaee5-b796-48d0-be3d-0aa980258321",
"emailAddress": "desk54a4fce541749088182888@contoso.com"
},
"mode": {
"@odata.type": "#microsoft.graph.reservablePlaceMode"
}
}
]
}