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
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.
Obtenha a caixa de correio Coleção de pastas na caixa de correio especificadaPasta numa caixa de correio.
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ão com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | MailboxFolder.Read | MailboxFolder.ReadWrite |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | MailboxFolder.Read.All | MailboxFolder.ReadWrite.All |
Solicitação HTTP
GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders
Parâmetros de consulta opcionais
Este método dá suporte a alguns parâmetros de consulta OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
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-sucedido, este método devolve um 200 OK código de resposta e uma coleção de objetos mailboxFolder no corpo da resposta.
Exemplos
Solicitação
O exemplo seguinte mostra como obter a coleção de pastas de caixa de correio numa pasta especificada.
GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA==/childFolders
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
Content-length: 232
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders('NJWt2LeVEAAAIBDAAAAA==')/childFolders",
"value": [
{
"@odata.type": "#microsoft.graph.mailboxFolder",
"id": "EDSVrdi3lRAAEvNS16AAA=",
"displayName": "Folder_1",
"parentFolderId": "NJWt2LeVEAAAIBDAAAAA==",
"parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93",
"childFolderCount": 0,
"totalItemCount": 20,
"type": "IPF.Note"
},
{
"@odata.type": "#microsoft.graph.mailboxFolder",
"id": "EDSVrdi3lRAAEED0yTAAA=",
"displayName": "Folder_2",
"parentFolderId": "NJWt2LeVEAAAIBDAAAAA==",
"parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93",
"childFolderCount": 0,
"totalItemCount": 1,
"type": "IPF.Note"
}
]
}