tipo de recurso mailSearchFolder

  • Artigo

Namespace: microsoft.graph

Uma mailSearchFolder é uma pasta virtual na caixa de correio do utilizador que contém todos os itens de e-mail que correspondem aos critérios de pesquisa especificados. mailSearchFolder herda de mailFolder. As pastas de pesquisa podem ser criadas em qualquer pasta na caixa de correio do Exchange Online de um utilizador. No entanto, para que uma pasta de pesquisa seja apresentada no Outlook, Outlook para a Web ou Outlook Live, a pasta tem de ser criada na pasta WellKnownFolderName.SearchFolders .

Ciclo de vida da pasta de pesquisa

As pastas de pesquisa criadas pela sua aplicação podem ser eliminadas pelo Exchange Online por um dos seguintes motivos:

  1. As pastas de pesquisa expiram após 45 dias sem utilização.
  2. Existem limites no número de pastas de pesquisa que podem ser criadas por pasta de origem. Quando este limite é violado, as pastas de pesquisa mais antigas são eliminadas para dar lugar a novas pastas.

Quando uma pasta de pesquisa é eliminada, a sua aplicação deve criar um novo recurso de pasta de pesquisa e utilizar o mesmo.

Métodos

Método Tipo de retorno Descrição
Criar pasta de pesquisa de email mailSearchFolder Crie uma pasta de pesquisa na caixa de correio deste utilizador.
Listar pastas filho Coleção mailFolder Liste todas as pastas na caixa de correio deste utilizador, incluindo pastas de pesquisa.
Obter pasta de pesquisa de email mailSearchFolder Obtenha a pasta de pesquisa especificada.
Atualizar pasta de pesquisa de email mailSearchFolder Atualize a pasta de pesquisa especificada.
Excluir pasta de pesquisa de email Nenhum Elimine a pasta de pesquisa especificada.
Listar mensagens na pasta 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 da pasta da caixa de correio deve ser percorrida na pesquisa. true significa que deve ser feita uma pesquisa profunda para incluir pastas subordinadas na hierarquia de cada pasta especificada explicitamente 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 através de APIs REST.
sourceFolderIds String collection As pastas da caixa de correio que devem ser extraídas.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "isSupported": true,
  "includeNestedFolders": true,
  "sourceFolderIds": ["string"],
  "filterQuery": "string"
}