tipo de recurso mailSearchFolder
Namespace: microsoft.graph
Um mailSearchFolder é uma pasta virtual na caixa de correio do usuário que contém todos os itens de email que correspondem aos critérios de pesquisa especificados. mailSearchFolder herda do mailFolder. Pesquisa pastas podem ser criadas em qualquer pasta na caixa de correio Exchange Online do usuário. No entanto, para que uma pasta de pesquisa apareça no Outlook, Outlook para a Web ou Outlook Live, a pasta deve ser criada na pasta WellKnownFolderName.SearchFolders.
ciclo de vida da pasta Pesquisa
Pesquisa pastas criadas pelo aplicativo podem ser excluídas por Exchange Online por um dos seguintes motivos:
- Pesquisa pastas expiram após 45 dias sem uso.
- Há limites no número de pastas de pesquisa que podem ser criadas por pasta de origem. Quando esse limite é violado, pastas de pesquisa mais antigas são excluídas para abrir caminho para novas.
Quando uma pasta de pesquisa é excluída, seu aplicativo deve criar um novo recurso de pasta de pesquisa e usar o mesmo.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
Criar uma pasta de pesquisa | mailSearchFolder | Crie uma pasta de pesquisa na caixa de correio deste usuário. |
Listar pastas de pesquisa | Coleção mailFolder | Liste todas as pastas na caixa de correio deste usuário, incluindo pastas de pesquisa. |
Obter uma pasta de pesquisa | mailSearchFolder | Obtenha a pasta de pesquisa especificada. |
Atualizar uma pasta de pesquisa | mailSearchFolder | Atualize a pasta de pesquisa especificada. |
Excluir uma pasta de pesquisa | Nenhum | Exclua a pasta de pesquisa especificada. |
Listar todas as mensagens em uma pasta de pesquisa | Coleção message | Liste todas as mensagens na pasta de pesquisa especificada. |
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
filterQuery | Cadeia de caracteres | A consulta OData para filtrar as mensagens. |
includeNestedFolders | Booliano | Indica como a hierarquia de pastas de caixa de correio deve ser percorrida na pesquisa. true significa que uma pesquisa profunda deve ser feita para incluir pastas filho na hierarquia de cada pasta explicitamente especificada em sourceFolderIds. false significa uma pesquisa superficial de apenas cada uma das pastas especificadas explicitamente em sourceFolderIds. |
Issupported | Booliano | Indica se uma pasta de pesquisa é editável usando APIs REST. |
sourceFolderIds | Coleção de cadeias de caracteres | As pastas de caixa de correio que devem ser extraídas. |
Representação JSON
Veja a seguir uma representação JSON do recurso.
{
"isSupported": true,
"includeNestedFolders": true,
"sourceFolderIds": ["string"],
"filterQuery": "string"
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários