tipo de recurso mailSearchFolder

  • Artigo

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:

  1. Pesquisa pastas expiram após 45 dias sem uso.
  2. 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"
}